diff options
Diffstat (limited to 'doc/man/man3/tqstring.3qt')
| -rw-r--r-- | doc/man/man3/tqstring.3qt | 80 |
1 files changed, 40 insertions, 40 deletions
diff --git a/doc/man/man3/tqstring.3qt b/doc/man/man3/tqstring.3qt index 59383a654..2a37c4463 100644 --- a/doc/man/man3/tqstring.3qt +++ b/doc/man/man3/tqstring.3qt @@ -25,7 +25,7 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "\fBTQString\fR ( const TQString & s )" .br .ti -1c -.BI "\fBTQString\fR ( const QByteArray & ba )" +.BI "\fBTQString\fR ( const TQByteArray & ba )" .br .ti -1c .BI "\fBTQString\fR ( const TQChar * unicode, uint length )" @@ -49,7 +49,7 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "TQString & \fBoperator=\fR ( const std::string & s )" .br .ti -1c -.BI "TQString & \fBoperator=\fR ( const QCString & cstr )" +.BI "TQString & \fBoperator=\fR ( const TQCString & cstr )" .br .ti -1c .BI "TQString & \fBoperator=\fR ( TQChar c )" @@ -133,7 +133,7 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "int \fBfind\fR ( const TQString & str, int index = 0, bool cs = TRUE ) const" .br .ti -1c -.BI "int \fBfind\fR ( const QRegExp & rx, int index = 0 ) const" +.BI "int \fBfind\fR ( const TQRegExp & rx, int index = 0 ) const" .br .ti -1c .BI "int \fBfind\fR ( const char * str, int index = 0 ) const" @@ -148,7 +148,7 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "int \fBfindRev\fR ( const TQString & str, int index = -1, bool cs = TRUE ) const" .br .ti -1c -.BI "int \fBfindRev\fR ( const QRegExp & rx, int index = -1 ) const" +.BI "int \fBfindRev\fR ( const TQRegExp & rx, int index = -1 ) const" .br .ti -1c .BI "int \fBfindRev\fR ( const char * str, int index = -1 ) const" @@ -166,7 +166,7 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "int \fBcontains\fR ( const TQString & str, bool cs = TRUE ) const" .br .ti -1c -.BI "int \fBcontains\fR ( const QRegExp & rx ) const" +.BI "int \fBcontains\fR ( const TQRegExp & rx ) const" .br .ti -1c .BI "enum \fBSectionFlags\fR { SectionDefault = 0x00, SectionSkipEmpty = 0x01, SectionIncludeLeadingSep = 0x02, SectionIncludeTrailingSep = 0x04, SectionCaseInsensitiveSeps = 0x08 }" @@ -184,7 +184,7 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "TQString \fBsection\fR ( const TQString & sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const" .br .ti -1c -.BI "TQString \fBsection\fR ( const QRegExp & reg, int start, int end = 0xffffffff, int flags = SectionDefault ) const" +.BI "TQString \fBsection\fR ( const TQRegExp & reg, int start, int end = 0xffffffff, int flags = SectionDefault ) const" .br .ti -1c .BI "TQString \fBleft\fR ( uint len ) const" @@ -217,7 +217,7 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "TQString & \fBinsert\fR ( uint index, const TQString & s )" .br .ti -1c -.BI "TQString & \fBinsert\fR ( uint index, const QByteArray & s )" +.BI "TQString & \fBinsert\fR ( uint index, const TQByteArray & s )" .br .ti -1c .BI "TQString & \fBinsert\fR ( uint index, const char * s )" @@ -241,7 +241,7 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "TQString & \fBappend\fR ( const TQString & str )" .br .ti -1c -.BI "TQString & \fBappend\fR ( const QByteArray & str )" +.BI "TQString & \fBappend\fR ( const TQByteArray & str )" .br .ti -1c .BI "TQString & \fBappend\fR ( const char * str )" @@ -259,7 +259,7 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "TQString & \fBprepend\fR ( const TQString & s )" .br .ti -1c -.BI "TQString & \fBprepend\fR ( const QByteArray & s )" +.BI "TQString & \fBprepend\fR ( const TQByteArray & s )" .br .ti -1c .BI "TQString & \fBprepend\fR ( const char * s )" @@ -283,7 +283,7 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "TQString & \fBremove\fR ( const char * str )" .br .ti -1c -.BI "TQString & \fBremove\fR ( const QRegExp & rx )" +.BI "TQString & \fBremove\fR ( const TQRegExp & rx )" .br .ti -1c .BI "TQString & \fBreplace\fR ( uint index, uint len, const TQString & s )" @@ -307,7 +307,7 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "TQString & \fBreplace\fR ( const TQString & before, const TQString & after, bool cs = TRUE )" .br .ti -1c -.BI "TQString & \fBreplace\fR ( const QRegExp & rx, const TQString & after )" +.BI "TQString & \fBreplace\fR ( const TQRegExp & rx, const TQString & after )" .br .ti -1c .BI "TQString & \fBreplace\fR ( TQChar c1, TQChar c2 )" @@ -379,7 +379,7 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "TQString & \fBoperator+=\fR ( const TQString & str )" .br .ti -1c -.BI "TQString & \fBoperator+=\fR ( const QByteArray & str )" +.BI "TQString & \fBoperator+=\fR ( const TQByteArray & str )" .br .ti -1c .BI "TQString & \fBoperator+=\fR ( const char * str )" @@ -421,10 +421,10 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "const char * \fBlatin1\fR () const" .br .ti -1c -.BI "QCString \fButf8\fR () const" +.BI "TQCString \fButf8\fR () const" .br .ti -1c -.BI "QCString \fBlocal8Bit\fR () const" +.BI "TQCString \fBlocal8Bit\fR () const" .br .ti -1c .BI "bool \fBoperator!\fR () const" @@ -601,7 +601,7 @@ In all of the TQString methods that take \fCconst char *\fR parameters, the \fCc .PP A TQString that has not been assigned to anything is \fInull\fR, i.e. both the length and data pointer is 0. A TQString that references the empty string ("", a single '\0' char) is \fIempty\fR. Both null and empty TQStrings are legal parameters to the methods. Assigning \fC(const char *) 0\fR to TQString gives a null TQString. For convenience, TQString::null is a null TQString. When sorting, empty strings come first, followed by non-empty strings, followed by null strings. We recommend using \fCif ( !str.isNull() )\fR to check for a non-null string rather than \fCif ( !str )\fR; see operator!() for an explanation. .PP -Note that if you find that you are mixing usage of QCString, TQString, and QByteArray, this causes lots of unnecessary copying and might indicate that the true nature of the data you are dealing with is uncertain. If the data is '\0'-terminated 8-bit data, use QCString; if it is unterminated (i.e. contains '\0's) 8-bit data, use QByteArray; if it is text, use TQString. +Note that if you find that you are mixing usage of TQCString, TQString, and TQByteArray, this causes lots of unnecessary copying and might indicate that the true nature of the data you are dealing with is uncertain. If the data is '\0'-terminated 8-bit data, use TQCString; if it is unterminated (i.e. contains '\0's) 8-bit data, use TQByteArray; if it is text, use TQString. .PP Lists of strings are handled by the TQStringList class. You can split a string into a list of strings using TQStringList::split(), and join a list of strings into a single string with an optional separator using TQStringList::join(). You can obtain a list of strings from a string list that contain a particular substring or that match a particular regex using TQStringList::grep(). .PP @@ -653,9 +653,9 @@ Throughout Qt's source code you will encounter TQString usages like this: .PP The 'copying' of input to output is almost as fast as copying a pointer because behind the scenes copying is achieved by incrementing a reference count. TQString (like all Qt's implicitly shared classes) operates on a copy-on-write basis, only copying if an instance is actually changed. .PP -If you wish to create a deep copy of a TQString without losing any Unicode information then you should use QDeepCopy. +If you wish to create a deep copy of a TQString without losing any Unicode information then you should use TQDeepCopy. .PP -See also TQChar, QCString, QByteArray, QConstString, Implicitly and Explicitly Shared Classes, Text Related Classes, and Non-GUI Classes. +See also TQChar, TQCString, TQByteArray, QConstString, Implicitly and Explicitly Shared Classes, Text Related Classes, and Non-GUI Classes. .SS "Member Type Documentation" .SH "TQString::SectionFlags" .TP @@ -681,7 +681,7 @@ See also isNull(). Constructs a string of length one, containing the character \fIch\fR. .SH "TQString::TQString ( const TQString & s )" Constructs an implicitly shared copy of \fIs\fR. This is very fast since it only involves incrementing a reference count. -.SH "TQString::TQString ( const QByteArray & ba )" +.SH "TQString::TQString ( const TQByteArray & ba )" Constructs a string that is a deep copy of \fIba\fR interpreted as a classic C string. .SH "TQString::TQString ( const TQChar * unicode, uint length )" Constructs a string that is a deep copy of the first \fIlength\fR characters in the TQChar array. @@ -731,7 +731,7 @@ This is an overloaded member function, provided for convenience. It behaves esse Appends character \fIch\fR to the string and returns a reference to the result. .PP Equivalent to operator+=(). -.SH "TQString & TQString::append ( const QByteArray & str )" +.SH "TQString & TQString::append ( const TQByteArray & str )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Appends \fIstr\fR to the string and returns a reference to the result. @@ -997,7 +997,7 @@ This function counts overlapping strings, so in the example below, there are two .fi .PP See also findRev(). -.SH "int TQString::contains ( const QRegExp & rx ) const" +.SH "int TQString::contains ( const TQRegExp & rx ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Returns the number of times the regexp, \fIrx\fR, matches in the string. @@ -1008,7 +1008,7 @@ This function counts overlapping matches, so in the example below, there are fou .br TQString str = "banana and panama"; .br - QRegExp rxp = QRegExp( "a[nm]a", TRUE, FALSE ); + TQRegExp rxp = TQRegExp( "a[nm]a", TRUE, FALSE ); .br int i = str.contains( rxp ); // i == 4 .br @@ -1055,7 +1055,7 @@ If \fIlen\fR is negative (the default), the current string length is used. str.fill( 'g', 5 ); // string == "ggggg" .br .fi -.SH "int TQString::find ( const QRegExp & rx, int index = 0 ) const" +.SH "int TQString::find ( const TQRegExp & rx, int index = 0 ) const" Finds the first match of the regular expression \fIrx\fR, starting from position \fIindex\fR. If \fIindex\fR is -1, the search starts at the last character; if -2, at the next to last character and so on. (See findRev() for searching backwards.) .PP Returns the position of the first match of \fIrx\fR or -1 if no match was found. @@ -1064,7 +1064,7 @@ Returns the position of the first match of \fIrx\fR or -1 if no match was found. .br TQString string( "bananas" ); .br - int i = string.find( QRegExp("an"), 0 ); // i == 1 + int i = string.find( TQRegExp("an"), 0 ); // i == 1 .br .fi .PP @@ -1137,7 +1137,7 @@ If \fIcs\fR is TRUE (the default), the search is case sensitive; otherwise the s int i = string.findRev( "ana" ); // i == 3 .br .fi -.SH "int TQString::findRev ( const QRegExp & rx, int index = -1 ) const" +.SH "int TQString::findRev ( const TQRegExp & rx, int index = -1 ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Finds the first match of the regexp \fIrx\fR, starting at position \fIindex\fR and searching backwards. If the index is -1, the search starts at the last character, if it is -2, at the next to last character and so on. (See findRev() for searching backwards.) @@ -1148,7 +1148,7 @@ Returns the position of the match or -1 if no match was found. .br TQString string( "bananas" ); .br - int i = string.findRev( QRegExp("an") ); // i == 3 + int i = string.findRev( TQRegExp("an") ); // i == 3 .br .fi .PP @@ -1227,7 +1227,7 @@ See also remove() and replace(). .PP Examples: .)l themes/themes.cpp and xform/xform.cpp. -.SH "TQString & TQString::insert ( uint index, const QByteArray & s )" +.SH "TQString & TQString::insert ( uint index, const TQByteArray & s )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Inserts \fIs\fR into the string at position \fIindex\fR and returns a reference to the string. @@ -1342,7 +1342,7 @@ See also isNull() and isEmpty(). .PP Examples: .)l dirview/dirview.cpp, fileiconview/qfileiconview.cpp, network/networkprotocol/nntp.cpp, rot13/rot13.cpp, and themes/themes.cpp. -.SH "QCString TQString::local8Bit () const" +.SH "TQCString TQString::local8Bit () const" Returns the string encoded in a locale-specific format. On X11, this is the TQTextCodec::codecForLocale(). On Windows, it is a system-defined encoding. On Mac OS X, this always uses UTF-8 as the encoding. .PP See TQTextCodec for more diverse coding/decoding of Unicode strings. @@ -1503,7 +1503,7 @@ When you want the above semantics, use: See also isEmpty(). .SH "TQString & TQString::operator+= ( const TQString & str )" Appends \fIstr\fR to the string and returns a reference to the string. -.SH "TQString & TQString::operator+= ( const QByteArray & str )" +.SH "TQString & TQString::operator+= ( const TQByteArray & str )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Appends \fIstr\fR to the string and returns a reference to the string. @@ -1541,7 +1541,7 @@ See also isNull(). This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Makes a deep copy of \fIs\fR and returns a reference to the deep copy. -.SH "TQString & TQString::operator= ( const QCString & cstr )" +.SH "TQString & TQString::operator= ( const TQCString & cstr )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Assigns a deep copy of \fIcstr\fR, interpreted as a classic C string, to this string. Returns a reference to this string. @@ -1593,7 +1593,7 @@ Inserts \fIch\fR at the beginning of the string and returns a reference to the s Equivalent to insert(0, \fIch\fR). .PP See also insert(). -.SH "TQString & TQString::prepend ( const QByteArray & s )" +.SH "TQString & TQString::prepend ( const TQByteArray & s )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Inserts \fIs\fR at the beginning of the string and returns a reference to the string. @@ -1667,7 +1667,7 @@ This is the same as replace(\fIc\fR, ""). This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Removes every occurrence of \fIstr\fR in the string. Returns a reference to the string. -.SH "TQString & TQString::remove ( const QRegExp & rx )" +.SH "TQString & TQString::remove ( const TQRegExp & rx )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Removes every occurrence of the regular expression \fIrx\fR in the string. Returns a reference to the string. @@ -1750,7 +1750,7 @@ Example: // s == "English is English" .br .fi -.SH "TQString & TQString::replace ( const QRegExp & rx, const TQString & after )" +.SH "TQString & TQString::replace ( const TQRegExp & rx, const TQString & after )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Replaces every occurrence of the regexp \fIrx\fR in the string with \fIafter\fR. Returns a reference to the string. For example: @@ -1759,7 +1759,7 @@ Replaces every occurrence of the regexp \fIrx\fR in the string with \fIafter\fR. .br TQString s = "banana"; .br - s.replace( QRegExp("an"), "" ); + s.replace( TQRegExp("an"), "" ); .br // s == "ba" .br @@ -1771,13 +1771,13 @@ For regexps containing capturing parentheses, occurrences of \fB\1\fR, \fB&# .br TQString t = "A <i>bon mot</i>."; .br - t.replace( QRegExp("<i>([^<]*)</i>"), "\\\\emph{\\\\1}" ); + t.replace( TQRegExp("<i>([^<]*)</i>"), "\\\\emph{\\\\1}" ); .br // t == "A \\\\emph{bon mot}." .br .fi .PP -See also find(), findRev(), and QRegExp::cap(). +See also find(), findRev(), and TQRegExp::cap(). .SH "TQString & TQString::replace ( TQChar c1, TQChar c2 )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP @@ -1915,7 +1915,7 @@ If \fIstart\fR or \fIend\fR is negative, we count fields from the right of the s .fi .PP See also TQStringList::split(). -.SH "TQString TQString::section ( const QRegExp & reg, int start, int end = 0xffffffff, int flags = SectionDefault ) const" +.SH "TQString TQString::section ( const TQRegExp & reg, int start, int end = 0xffffffff, int flags = SectionDefault ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP This function returns a section of the string. @@ -1928,7 +1928,7 @@ The \fIflags\fR argument can be used to affect some aspects of the function's be .br TQString line( "forename\\tmiddlename surname \\t \\t phone" ); .br - QRegExp sep( "\\s+" ); + TQRegExp sep( "\\s+" ); .br TQString s = line.section( sep, 2, 2 ); // s == "surname" .br @@ -1940,13 +1940,13 @@ If \fIstart\fR or \fIend\fR is negative, we count fields from the right of the s .br TQString line( "forename\\tmiddlename surname \\t \\t phone" ); .br - QRegExp sep( "\\\\s+" ); + TQRegExp sep( "\\\\s+" ); .br TQString s = line.section( sep, -3, -2 ); // s == "middlename surname" .br .fi .PP -\fBWarning:\fR Using this QRegExp version is much more expensive than the overloaded string and character versions. +\fBWarning:\fR Using this TQRegExp version is much more expensive than the overloaded string and character versions. .PP See also TQStringList::split() and simplifyWhiteSpace(). .SH "TQString & TQString::setAscii ( const char * str, int len = -1 )" @@ -2391,7 +2391,7 @@ See also lower(). .PP Examples: .)l scribble/scribble.cpp and sql/overview/custom1/main.cpp. -.SH "QCString TQString::utf8 () const" +.SH "TQCString TQString::utf8 () const" Returns the string encoded in UTF-8 format. .PP See TQTextCodec for more diverse coding/decoding of Unicode strings. |