You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tqt3/doc/html/tqcstring-h.html

424 lines
15 KiB

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/tqcstring.h:1 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>tqcstring.h Include File</title>
<style type="text/css"><!--
fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
--></style>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
<a href="index.html">
<font color="#004faf">Home</font></a>
| <a href="classes.html">
<font color="#004faf">All&nbsp;Classes</font></a>
| <a href="mainclasses.html">
<font color="#004faf">Main&nbsp;Classes</font></a>
| <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
| <a href="groups.html">
<font color="#004faf">Grouped&nbsp;Classes</font></a>
| <a href="functions.html">
<font color="#004faf">Functions</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>tqcstring.h</h1>
<p>This is the verbatim text of the tqcstring.h include file. It is provided only for illustration; the copyright remains with Trolltech.
<hr>
<pre>
/****************************************************************************
** $Id: qt/tqcstring.h 3.3.8 edited Jan 11 14:38 $
**
** Definition of the extended char array operations,
** and TQByteArray and TQCString classes
**
** Created : 920609
**
** Copyright (C) 1992-2007 Trolltech ASA. All rights reserved.
**
** This file is part of the tools module of the TQt GUI Toolkit.
**
** This file may be used under the terms of the GNU General Public
** License versions 2.0 or 3.0 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file. Alternatively you may (at your option) use any
** later version of the GNU General Public License if such license has
** been publicly approved by Trolltech ASA (or its successors, if any)
** and the KDE Free TQt Foundation.
**
** Please review the following information to ensure GNU General
** Public Licensing requirements will be met:
** http://trolltech.com/products/qt/licenses/licensing/opensource/.
** If you are unsure which license is appropriate for your use, please
** review the following information:
** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
** or contact the sales department at sales@trolltech.com.
**
** This file may be used under the terms of the Q Public License as
** defined by Trolltech ASA and appearing in the file LICENSE.TQPL
** included in the packaging of this file. Licensees holding valid TQt
** Commercial licenses may use this file in accordance with the TQt
** Commercial License Agreement provided with the Software.
**
** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
** herein.
**
**********************************************************************/
#ifndef TQCSTRING_H
#define TQCSTRING_H
#ifndef QT_H
#include "tqmemarray.h"
#endif // QT_H
#include &lt;string.h&gt;
/*****************************************************************************
Safe and portable C string functions; extensions to standard string.h
*****************************************************************************/
TQ_EXPORT void *tqmemmove( void *dst, const void *src, uint len );
TQ_EXPORT char *tqstrdup( const char * );
TQ_EXPORT inline uint tqstrlen( const char *str )
{ return str ? (uint)strlen(str) : 0u; }
TQ_EXPORT inline char *qstrcpy( char *dst, const char *src )
{ return src ? strcpy(dst, src) : 0; }
TQ_EXPORT char *tqstrncpy( char *dst, const char *src, uint len );
TQ_EXPORT inline int qstrcmp( const char *str1, const char *str2 )
{
return ( str1 &amp;&amp; str2 ) ? strcmp( str1, str2 )
: ( str1 ? 1 : ( str2 ? -1 : 0 ) );
}
TQ_EXPORT inline int tqstrncmp( const char *str1, const char *str2, uint len )
{
return ( str1 &amp;&amp; str2 ) ? strncmp( str1, str2, len )
: ( str1 ? 1 : ( str2 ? -1 : 0 ) );
}
TQ_EXPORT int tqstricmp( const char *, const char * );
TQ_EXPORT int tqstrnicmp( const char *, const char *, uint len );
// tqChecksum: Internet checksum
TQ_EXPORT TQ_UINT16 tqChecksum( const char *s, uint len );
/*****************************************************************************
TQByteArray class
*****************************************************************************/
#if defined(Q_QDOC)
/*
We want qdoc to document TQByteArray as a real class that inherits
TQMemArray&lt;char&gt; and that is inherited by TQBitArray.
*/
class TQByteArray : public TQMemArray&lt;char&gt;
{
public:
TQByteArray();
TQByteArray( int size );
};
#else
typedef TQMemArray&lt;char&gt; TQByteArray;
#endif
#ifndef TQT_NO_COMPRESS
TQ_EXPORT TQByteArray tqCompress( const uchar* data, int nbytes );
TQ_EXPORT TQByteArray tqUncompress( const uchar* data, int nbytes );
TQ_EXPORT inline TQByteArray tqCompress( const TQByteArray&amp; data)
{ return tqCompress( (const uchar*)data.data(), data.size() ); }
TQ_EXPORT inline TQByteArray tqUncompress( const TQByteArray&amp; data )
{ return tqUncompress( (const uchar*)data.data(), data.size() ); }
#endif
/*****************************************************************************
TQByteArray stream functions
*****************************************************************************/
#ifndef TQT_NO_DATASTREAM
TQ_EXPORT TQDataStream &amp;operator&lt;&lt;( TQDataStream &amp;, const TQByteArray &amp; );
TQ_EXPORT TQDataStream &amp;operator&gt;&gt;( TQDataStream &amp;, TQByteArray &amp; );
#endif
/*****************************************************************************
TQCString class
*****************************************************************************/
class TQRegExp;
class TQ_EXPORT TQCString : public TQByteArray // C string class
{
public:
TQCString() {} // make null string
TQCString( int size ); // allocate size incl. \0
TQCString( const TQCString &amp;s ) : TQByteArray( s ) {}
TQCString( const char *str ); // deep copy
TQCString( const char *str, uint maxlen ); // deep copy, max length
~TQCString();
TQCString &amp;operator=( const TQCString &amp;s );// shallow copy
TQCString &amp;operator=( const char *str ); // deep copy
bool isNull() const;
bool isEmpty() const;
uint length() const;
bool resize( uint newlen );
bool truncate( uint pos );
bool fill( char c, int len = -1 );
TQCString copy() const;
TQCString &amp;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;
#ifndef TQT_NO_REGEXP
int find( const TQRegExp &amp;, int index=0 ) const;
#endif
int findRev( char c, int index=-1, bool cs=TRUE) const;
int findRev( const char *str, int index=-1, bool cs=TRUE) const;
#ifndef TQT_NO_REGEXP_CAPTURE
int findRev( const TQRegExp &amp;, int index=-1 ) const;
#endif
int contains( char c, bool cs=TRUE ) const;
int contains( const char *str, bool cs=TRUE ) const;
#ifndef TQT_NO_REGEXP
int contains( const TQRegExp &amp; ) const;
#endif
TQCString left( uint len ) const;
TQCString right( uint len ) const;
TQCString mid( uint index, uint len=0xffffffff) const;
TQCString leftJustify( uint width, char fill=' ', bool trunc=FALSE)const;
TQCString rightJustify( uint width, char fill=' ',bool trunc=FALSE)const;
TQCString lower() const;
TQCString upper() const;
TQCString stripWhiteSpace() const;
TQCString simplifyWhiteSpace() const;
TQCString &amp;insert( uint index, const char * );
TQCString &amp;insert( uint index, char );
TQCString &amp;append( const char * );
TQCString &amp;prepend( const char * );
TQCString &amp;remove( uint index, uint len );
TQCString &amp;replace( uint index, uint len, const char * );
#ifndef TQT_NO_REGEXP
TQCString &amp;replace( const TQRegExp &amp;, const char * );
#endif
TQCString &amp;replace( char c, const char *after );
TQCString &amp;replace( const char *, const char * );
TQCString &amp;replace( char, 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;
float toFloat( bool *ok=0 ) const;
double toDouble( bool *ok=0 ) const;
TQCString &amp;setStr( const char *s );
TQCString &amp;setNum( short );
TQCString &amp;setNum( ushort );
TQCString &amp;setNum( int );
TQCString &amp;setNum( uint );
TQCString &amp;setNum( long );
TQCString &amp;setNum( ulong );
TQCString &amp;setNum( float, char f='g', int prec=6 );
TQCString &amp;setNum( double, char f='g', int prec=6 );
bool setExpand( uint index, char c );
operator const char *() const;
TQCString &amp;operator+=( const char *str );
TQCString &amp;operator+=( char c );
private:
int find( const char *str, int index, bool cs, uint l ) const;
};
/*****************************************************************************
TQCString stream functions
*****************************************************************************/
#ifndef TQT_NO_DATASTREAM
TQ_EXPORT TQDataStream &amp;operator&lt;&lt;( TQDataStream &amp;, const TQCString &amp; );
TQ_EXPORT TQDataStream &amp;operator&gt;&gt;( TQDataStream &amp;, TQCString &amp; );
#endif
/*****************************************************************************
TQCString inline functions
*****************************************************************************/
inline TQCString &amp;TQCString::operator=( const TQCString &amp;s )
{ return (TQCString&amp;)assign( s ); }
inline TQCString &amp;TQCString::operator=( const char *str )
{ return (TQCString&amp;)duplicate( str, tqstrlen(str)+1 ); }
inline bool TQCString::isNull() const
{ return data() == 0; }
inline bool TQCString::isEmpty() const
{ return data() == 0 || *data() == '\0'; }
inline uint TQCString::length() const
{ return tqstrlen( data() ); }
inline bool TQCString::truncate( uint pos )
{ return resize(pos+1); }
inline TQCString TQCString::copy() const
{ return TQCString( data() ); }
inline TQCString &amp;TQCString::prepend( const char *s )
{ return insert(0,s); }
inline TQCString &amp;TQCString::append( const char *s )
{ return operator+=(s); }
inline TQCString &amp;TQCString::setNum( short n )
{ return setNum((long)n); }
inline TQCString &amp;TQCString::setNum( ushort n )
{ return setNum((ulong)n); }
inline TQCString &amp;TQCString::setNum( int n )
{ return setNum((long)n); }
inline TQCString &amp;TQCString::setNum( uint n )
{ return setNum((ulong)n); }
inline TQCString &amp;TQCString::setNum( float n, char f, int prec )
{ return setNum((double)n,f,prec); }
inline TQCString::operator const char *() const
{ return (const char *)data(); }
/*****************************************************************************
TQCString non-member operators
*****************************************************************************/
TQ_EXPORT inline bool operator==( const TQCString &amp;s1, const TQCString &amp;s2 )
{ return qstrcmp( s1.data(), s2.data() ) == 0; }
TQ_EXPORT inline bool operator==( const TQCString &amp;s1, const char *s2 )
{ return qstrcmp( s1.data(), s2 ) == 0; }
TQ_EXPORT inline bool operator==( const char *s1, const TQCString &amp;s2 )
{ return qstrcmp( s1, s2.data() ) == 0; }
TQ_EXPORT inline bool operator!=( const TQCString &amp;s1, const TQCString &amp;s2 )
{ return qstrcmp( s1.data(), s2.data() ) != 0; }
TQ_EXPORT inline bool operator!=( const TQCString &amp;s1, const char *s2 )
{ return qstrcmp( s1.data(), s2 ) != 0; }
TQ_EXPORT inline bool operator!=( const char *s1, const TQCString &amp;s2 )
{ return qstrcmp( s1, s2.data() ) != 0; }
TQ_EXPORT inline bool operator&lt;( const TQCString &amp;s1, const TQCString&amp; s2 )
{ return qstrcmp( s1.data(), s2.data() ) &lt; 0; }
TQ_EXPORT inline bool operator&lt;( const TQCString &amp;s1, const char *s2 )
{ return qstrcmp( s1.data(), s2 ) &lt; 0; }
TQ_EXPORT inline bool operator&lt;( const char *s1, const TQCString &amp;s2 )
{ return qstrcmp( s1, s2.data() ) &lt; 0; }
TQ_EXPORT inline bool operator&lt;=( const TQCString &amp;s1, const TQCString &amp;s2 )
{ return qstrcmp( s1.data(), s2.data() ) &lt;= 0; }
TQ_EXPORT inline bool operator&lt;=( const TQCString &amp;s1, const char *s2 )
{ return qstrcmp( s1.data(), s2 ) &lt;= 0; }
TQ_EXPORT inline bool operator&lt;=( const char *s1, const TQCString &amp;s2 )
{ return qstrcmp( s1, s2.data() ) &lt;= 0; }
TQ_EXPORT inline bool operator&gt;( const TQCString &amp;s1, const TQCString &amp;s2 )
{ return qstrcmp( s1.data(), s2.data() ) &gt; 0; }
TQ_EXPORT inline bool operator&gt;( const TQCString &amp;s1, const char *s2 )
{ return qstrcmp( s1.data(), s2 ) &gt; 0; }
TQ_EXPORT inline bool operator&gt;( const char *s1, const TQCString &amp;s2 )
{ return qstrcmp( s1, s2.data() ) &gt; 0; }
TQ_EXPORT inline bool operator&gt;=( const TQCString &amp;s1, const TQCString&amp; s2 )
{ return qstrcmp( s1.data(), s2.data() ) &gt;= 0; }
TQ_EXPORT inline bool operator&gt;=( const TQCString &amp;s1, const char *s2 )
{ return qstrcmp( s1.data(), s2 ) &gt;= 0; }
TQ_EXPORT inline bool operator&gt;=( const char *s1, const TQCString &amp;s2 )
{ return qstrcmp( s1, s2.data() ) &gt;= 0; }
TQ_EXPORT inline const TQCString operator+( const TQCString &amp;s1,
const TQCString &amp;s2 )
{
TQCString tmp( s1.data() );
tmp += s2;
return tmp;
}
TQ_EXPORT inline const TQCString operator+( const TQCString &amp;s1, const char *s2 )
{
TQCString tmp( s1.data() );
tmp += s2;
return tmp;
}
TQ_EXPORT inline const TQCString operator+( const char *s1, const TQCString &amp;s2 )
{
TQCString tmp( s1 );
tmp += s2;
return tmp;
}
TQ_EXPORT inline const TQCString operator+( const TQCString &amp;s1, char c2 )
{
TQCString tmp( s1.data() );
tmp += c2;
return tmp;
}
TQ_EXPORT inline const TQCString operator+( char c1, const TQCString &amp;s2 )
{
TQCString tmp;
tmp += c1;
tmp += s2;
return tmp;
}
#include "ntqwinexport.h"
#endif // TQCSTRING_H
</pre>
<!-- eof -->
<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2007
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
<td align=right><div align=right>TQt 3.3.8</div>
</table></div></address></body>
</html>