/****************************************************************************

** 

**

** Definition of the extended char array operations,

** and QByteArray and QCString classes

**

** Created : 920609

**

** Copyright (C) 1992-2000 Trolltech AS.  All rights reserved.

**

** This file is part of the tools module of the Qt GUI Toolkit.

**

** This file may be distributed under the terms of the Q Public License

** as defined by Trolltech AS of Norway and appearing in the file

** LICENSE.QPL included in the packaging of this file.

**

** This file may be distributed and/or modified under the terms of the

** GNU General Public License version 2 as published by the Free Software

** Foundation and appearing in the file LICENSE.GPL included in the

** packaging of this file.

**

** Licensees holding valid Qt Enterprise Edition or Qt Professional Edition

** licenses may use this file in accordance with the Qt Commercial License

** Agreement provided with the Software.

**

** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE

** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

**

** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for

**   information about Qt Commercial License Agreements.

** See http://www.trolltech.com/qpl/ for QPL licensing information.

** See http://www.trolltech.com/gpl/ for GPL licensing information.

**

** Contact info@trolltech.com if any conditions of this licensing are

** not clear to you.

**

**********************************************************************/

#ifndef QCSTRING_H

#define QCSTRING_H

#ifndef QT_H

#include "qarray.h"

#endif // QT_H

#include <stdlib.h>

#include <string.h>

#if defined(_OS_SUN_) && defined(_CC_GNU_)

#include <strings.h>

#endif

class QGString;

/*****************************************************************************

  Fixes and workarounds for some platforms

 *****************************************************************************/

#if defined(_OS_HPUX_)

// HP-UX has badly defined strstr() etc.

// ### fix in 3.0: change hack_* to qt_hack_*

// by the way HP-UX is probably right, the standard has evolved and

// we'll have to adapt to it

inline char *hack_strstr( const char *s1, const char *s2 )

{ return (char *)strstr(s1, s2); }

inline char *hack_strchr( const char *s, int c )

{ return (char *)strchr(s, c); }

inline char *hack_strrchr( const char *s, int c )

{ return (char *)strrchr(s, c); }

#define strstr(s1,s2)	hack_strstr((s1),(s2))

#define strchr(s,c)	hack_strchr((s),(c))

#define strrchr(s,c)	hack_strrchr((s),(c))

#endif

/*****************************************************************************

  Safe and portable C string functions; extensions to standard string.h

 *****************************************************************************/

Q_EXPORT void *qmemmove( void *dst, const void *src, uint len );

#if defined(_OS_SUN_) || defined(_CC_OC_)

#define memmove(s1,s2,n) qmemmove((s1),(s2),(n))

#endif

Q_EXPORT char *qstrdup( const char * );

Q_EXPORT inline uint cstrlen( const char *str )

{ return strlen(str); }

Q_EXPORT inline uint qstrlen( const char *str )

{ return str ? strlen(str) : 0; }

Q_EXPORT inline char *cstrcpy( char *dst, const char *src )

{ return strcpy(dst,src); }

Q_EXPORT inline char *qstrcpy( char *dst, const char *src )

{ return src ? strcpy(dst, src) : 0; }

Q_EXPORT char *qstrncpy( char *dst, const char *src, uint len );

Q_EXPORT inline int cstrcmp( const char *str1, const char *str2 )

{ return strcmp(str1,str2); }

Q_EXPORT inline int qstrcmp( const char *str1, const char *str2 )

{ return (str1 && str2) ? strcmp(str1,str2) : (int)((long)str2 - (long)str1); }

Q_EXPORT inline int cstrncmp( const char *str1, const char *str2, uint len )

{ return strncmp(str1,str2,len); }

Q_EXPORT inline int qstrncmp( const char *str1, const char *str2, uint len )

{ return (str1 && str2) ? strncmp(str1,str2,len) :

			  (int)((long)str2 - (long)str1); }

Q_EXPORT int qstricmp( const char *, const char * );

Q_EXPORT int qstrnicmp( const char *, const char *, uint len );

// ### TODO for 3.0: these and the cstr* functions should be used if

//                   !defined(QT_CLEAN_NAMESPACE)

//                   We want to keep source compatibility for 2.x

// ### TODO for 4.0: completely remove these and the cstr* functions

#if !defined(QT_GENUINE_STR)

#undef	strlen

#define strlen qstrlen

#undef	strcpy

#define strcpy qstrcpy

#undef	strcmp

#define strcmp qstrcmp

#undef	strncmp

#define strncmp qstrncmp

#undef	stricmp

#define stricmp	 qstricmp

#undef	strnicmp

#define strnicmp qstrnicmp

#endif

// qChecksum: Internet checksum

Q_EXPORT Q_UINT16 qChecksum( const char *s, uint len );

/*****************************************************************************

  QByteArray class

 *****************************************************************************/

#if defined(Q_TEMPLATEDLL)

template class Q_EXPORT QArray<char>;

#endif

typedef QArray<char> QByteArray;

/*****************************************************************************

  QByteArray stream functions

 *****************************************************************************/

#ifndef QT_NO_DATASTREAM

Q_EXPORT QDataStream &operator<<( QDataStream &, const QByteArray & );

Q_EXPORT QDataStream &operator>>( QDataStream &, QByteArray & );

#endif

class QRegExp;

/** This is an alternative implementation of QCString. It provides basically

 *  the same functions but uses less memory for administration. This class

 *  is just a wrapper around a plain C string requiring only 4 bytes "overhead".

 *  QCString features sharing of data and stores the string length, but 

 *  requires 4 + 12 bytes for this (even for the empty string). As doxygen 

 *  uses a LOT of string during a run it saves a lot of memory to use a 

 *  more memory efficient implementation at the cost of relatively low

 *  runtime overhead.

 */

class QCString 

{

public:

    QCString() : m_data(0) {}		// make null string

    QCString( const QCString &s );

    QCString( int size );

    QCString( const char *str );

    QCString( const char *str, uint maxlen );

    ~QCString();

    QCString    &operator=( const QCString &s );// deep copy

    QCString    &operator=( const char *str );	// deep copy

    bool        isNull()        const;

    bool	isEmpty()	const;

    uint	length()	const;

    uint        size()          const { return m_data ? length()+1 : 0; }

    char *      data()          const { return m_data; }

    bool	resize( uint newlen );

    bool	truncate( uint pos );

    bool	fill( char c, int len = -1 );

    QCString	copy()	const;

    QCString    &sprintf( const char *format, ... );

    int		find( char c, int index=0, bool cs=TRUE ) const;

    int		find( const char *str, int index=0, bool cs=TRUE ) const;

    int		find( const QRegExp &, int index=0 ) const;

    int		findRev( char c, int index=-1, bool cs=TRUE) const;

    int		findRev( const char *str, int index=-1, bool cs=TRUE) const;

    int		findRev( const QRegExp &, int index=-1 ) const;

    int		contains( char c, bool cs=TRUE ) const;

    int		contains( const char *str, bool cs=TRUE ) const;

    int		contains( const QRegExp & ) const;

    bool        stripPrefix(const char *prefix);

    QCString	left( uint len )  const;

    QCString	right( uint len ) const;

    QCString	mid( uint index, uint len=0xffffffff) const;

    QCString	lower() const;

    QCString	upper() const;

    QCString	stripWhiteSpace()	const;

    QCString	simplifyWhiteSpace()	const;

    QCString    &assign( const char *str );

    QCString    &insert( uint index, const char * );

    QCString    &insert( uint index, char );

    QCString    &append( const char *s );

    QCString    &prepend( const char *s );

    QCString    &remove( uint index, uint len );

    QCString    &replace( uint index, uint len, const char * );

    QCString    &replace( const QRegExp &, const char * );

    short	toShort( bool *ok=0 )	const;

    ushort	toUShort( bool *ok=0 )	const;

    int		toInt( bool *ok=0 )	const;

    uint	toUInt( bool *ok=0 )	const;

    long	toLong( bool *ok=0 )	const;

    ulong	toULong( bool *ok=0 )	const;

    QCString    &setNum( short );

    QCString    &setNum( ushort );

    QCString    &setNum( int );

    QCString    &setNum( uint );

    QCString    &setNum( long );

    QCString    &setNum( ulong );

    QCString    &setNum( float, char f='g', int prec=6 );

    QCString    &setNum( double, char f='g', int prec=6 );

		operator const char *() const;

    QCString    &operator+=( const char *str );

    QCString    &operator+=( char c );

    char &at( uint index ) const;

    char &operator[]( int i ) const { return at(i); }

  private:

    static void msg_index( uint );

    void duplicate( const QCString &s );

    void duplicate( const char *str);

    QCString &duplicate( const char *str, int);

    char *      m_data;

};

inline char &QCString::at( uint index ) const

{

  return m_data[index];

}

inline void QCString::duplicate( const QCString &s )

{

  if (!s.isEmpty()) 

  {

    uint l = strlen(s.data());

    m_data = (char *)malloc(l+1);

    if (m_data) memcpy(m_data,s.data(),l+1);

  }

  else 

    m_data=0; 

}

inline void QCString::duplicate( const char *str)

{

  if (str && str[0]!='\0') 

  {

    uint l = strlen(str);

    m_data = (char *)malloc(l+1);

    if (m_data) memcpy(m_data,str,l+1);

  }

  else 

    m_data=0;

}

inline QCString &QCString::duplicate( const char *str, int)

{

  if (m_data==str) return *this;

  if (m_data) free(m_data);

  duplicate(str);

  return *this;

}

/*****************************************************************************

  QCString stream functions

 *****************************************************************************/

#ifndef QT_NO_DATASTREAM

Q_EXPORT QDataStream &operator<<( QDataStream &, const QCString & );

Q_EXPORT QDataStream &operator>>( QDataStream &, QCString & );

#endif

/*****************************************************************************

  QCString inline functions

 *****************************************************************************/

inline QCString &QCString::operator=( const QCString &s )

{ return (QCString&)assign( s ); }

inline QCString &QCString::operator=( const char *str )

{ return (QCString&)duplicate( str, qstrlen(str)+1 ); }

inline bool QCString::isNull() const

{ return data() == 0; }

inline bool QCString::isEmpty() const

{ return data() == 0 || *data() == '\0'; }

inline uint QCString::length() const

{ return qstrlen( data() ); }

inline bool QCString::truncate( uint pos )

{ return resize(pos+1); }

inline QCString QCString::copy() const

{ return QCString( data() ); }

inline QCString &QCString::prepend( const char *s )

{ return insert(0,s); }

inline QCString &QCString::append( const char *s )

{ return operator+=(s); }

inline QCString &QCString::setNum( short n )

{ return setNum((long)n); }

inline QCString &QCString::setNum( ushort n )

{ return setNum((ulong)n); }

inline QCString &QCString::setNum( int n )

{ return setNum((long)n); }

inline QCString &QCString::setNum( uint n )

{ return setNum((ulong)n); }

inline QCString &QCString::setNum( float n, char f, int prec )

{ return setNum((double)n,f,prec); }

inline QCString::operator const char *() const

{ return (const char *)data(); }

/*****************************************************************************

  QCString non-member operators

 *****************************************************************************/

Q_EXPORT inline bool operator==( const QCString &s1, const QCString &s2 )

{ return qstrcmp(s1.data(),s2.data()) == 0; }

Q_EXPORT inline bool operator==( const QCString &s1, const char *s2 )

{ return qstrcmp(s1.data(),s2) == 0; }

Q_EXPORT inline bool operator==( const char *s1, const QCString &s2 )

{ return qstrcmp(s1,s2.data()) == 0; }

Q_EXPORT inline bool operator!=( const QCString &s1, const QCString &s2 )

{ return qstrcmp(s1.data(),s2.data()) != 0; }

Q_EXPORT inline bool operator!=( const QCString &s1, const char *s2 )

{ return qstrcmp(s1.data(),s2) != 0; }

Q_EXPORT inline bool operator!=( const char *s1, const QCString &s2 )

{ return qstrcmp(s1,s2.data()) != 0; }

Q_EXPORT inline bool operator<( const QCString &s1, const QCString& s2 )

{ return qstrcmp(s1.data(),s2.data()) < 0; }

Q_EXPORT inline bool operator<( const QCString &s1, const char *s2 )

{ return qstrcmp(s1.data(),s2) < 0; }

Q_EXPORT inline bool operator<( const char *s1, const QCString &s2 )

{ return qstrcmp(s1,s2.data()) < 0; }

Q_EXPORT inline bool operator<=( const QCString &s1, const char *s2 )

{ return qstrcmp(s1.data(),s2) <= 0; }

Q_EXPORT inline bool operator<=( const char *s1, const QCString &s2 )

{ return qstrcmp(s1,s2.data()) <= 0; }

Q_EXPORT inline bool operator>( const QCString &s1, const char *s2 )

{ return qstrcmp(s1.data(),s2) > 0; }

Q_EXPORT inline bool operator>( const char *s1, const QCString &s2 )

{ return qstrcmp(s1,s2.data()) > 0; }

Q_EXPORT inline bool operator>=( const QCString &s1, const char *s2 )

{ return qstrcmp(s1.data(),s2) >= 0; }

Q_EXPORT inline bool operator>=( const char *s1, const QCString &s2 )

{ return qstrcmp(s1,s2.data()) >= 0; }

Q_EXPORT inline QCString operator+( const QCString &s1, const QCString &s2 )

{

    QCString tmp(s1);

    tmp += s2;

    return tmp;

}

inline QCString operator+( const QCString &s1, const QGString &s2 );

inline QCString operator+( const QGString &s1, const QCString &s2 );

Q_EXPORT inline QCString operator+( const QCString &s1, const char *s2 )

{

    QCString tmp(s1);

    tmp += s2;

    return tmp;

}

Q_EXPORT inline QCString operator+( const char *s1, const QCString &s2 )

{

    QCString tmp(s1);

    tmp += s2;

    return tmp;

}

Q_EXPORT inline QCString operator+( const QCString &s1, char c2 )

{

    QCString tmp( s1.data() );

    tmp += c2;

    return tmp;

}

Q_EXPORT inline QCString operator+( char c1, const QCString &s2 )

{

    QCString tmp;

    tmp += c1;

    tmp += s2;

    return tmp;

}

#endif // QCSTRING_H