📄 qcstring.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><!-- /home/reggie/tmp/qt-3.0-reggie-5401/qt-x11-commercial-3.0.5/src/tools/qcstring.cpp:382 --><html><head><meta http-equiv="Content-Type" content="text/html; charset=gb2312"><meta name="Translator" content="Cavendish"><meta name="Qt zh_CN Documents Website" content="http://www.qiliang.net/qt"><title>QCString类</title><style type="text/css"><!--h3.fn,span.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; font-family: "Times New Roman" }--></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">主页</font></a> | <a href="classes.html"><font color="#004faf">所有的类</font></a> | <a href="mainclasses.html"><font color="#004faf">主要的类</font></a> | <a href="annotated.html"><font color="#004faf">注释的类</font></a> | <a href="groups.html"><font color="#004faf">分组的类</font></a> | <a href="functions.html"><font color="#004faf">函数</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>QCString类参考</h1><p>QCString类提供了一个经典C语言的以零结尾的字符数组（char *）的抽象。<a href="#details">详情请见……</a><p><tt>#include <<a href="qcstring-h.html">qcstring.h</a>></tt><p>继承了<a href="qbytearray.html">QByteArray</a>。<p><a href="qcstring-members.html">所有成员函数的列表。</a><h2>公有成员</h2><ul><li><div class=fn><a href="#QCString"><b>QCString</b></a> ()</div></li><li><div class=fn><a href="#QCString-2"><b>QCString</b></a> ( int size )</div></li><li><div class=fn><a href="#QCString-3"><b>QCString</b></a> ( const QCString & s )</div></li><li><div class=fn><a href="#QCString-4"><b>QCString</b></a> ( const char * str )</div></li><li><div class=fn><a href="#QCString-5"><b>QCString</b></a> ( const char * str, uint maxsize )</div></li><li><div class=fn>QCString & <a href="#operator-eq"><b>operator=</b></a> ( const QCString & s )</div></li><li><div class=fn>QCString & <a href="#operator-eq-2"><b>operator=</b></a> ( const char * str )</div></li><li><div class=fn>bool <a href="#isNull"><b>isNull</b></a> () const</div></li><li><div class=fn>bool <a href="#isEmpty"><b>isEmpty</b></a> () const</div></li><li><div class=fn>uint <a href="#length"><b>length</b></a> () const</div></li><li><div class=fn>bool <a href="#resize"><b>resize</b></a> ( uint len )</div></li><li><div class=fn>bool <a href="#truncate"><b>truncate</b></a> ( uint pos )</div></li><li><div class=fn>bool <a href="#fill"><b>fill</b></a> ( char c, int len = -1 )</div></li><li><div class=fn>QCString <a href="#copy"><b>copy</b></a> () const</div></li><li><div class=fn>QCString & <a href="#sprintf"><b>sprintf</b></a> ( const char * format, ... )</div></li><li><div class=fn>int <a href="#find"><b>find</b></a> ( char c, int index = 0, bool cs = TRUE ) const</div></li><li><div class=fn>int <a href="#find-2"><b>find</b></a> ( const char * str, int index = 0, bool cs = TRUE ) const</div></li><li><div class=fn>int <a href="#find-3"><b>find</b></a> ( const QRegExp & rx, int index = 0 ) const</div></li><li><div class=fn>int <a href="#findRev"><b>findRev</b></a> ( char c, int index = -1, bool cs = TRUE ) const</div></li><li><div class=fn>int <a href="#findRev-2"><b>findRev</b></a> ( const char * str, int index = -1, bool cs = TRUE ) const</div></li><li><div class=fn>int <a href="#findRev-3"><b>findRev</b></a> ( const QRegExp & rx, int index = -1 ) const</div></li><li><div class=fn>int <a href="#contains"><b>contains</b></a> ( char c, bool cs = TRUE ) const</div></li><li><div class=fn>int <a href="#contains-2"><b>contains</b></a> ( const char * str, bool cs = TRUE ) const</div></li><li><div class=fn>int <a href="#contains-3"><b>contains</b></a> ( const QRegExp & rx ) const</div></li><li><div class=fn>QCString <a href="#left"><b>left</b></a> ( uint len ) const</div></li><li><div class=fn>QCString <a href="#right"><b>right</b></a> ( uint len ) const</div></li><li><div class=fn>QCString <a href="#mid"><b>mid</b></a> ( uint index, uint len = 0xffffffff ) const</div></li><li><div class=fn>QCString <a href="#leftJustify"><b>leftJustify</b></a> ( uint width, char fill = ' ', bool truncate = FALSE ) const</div></li><li><div class=fn>QCString <a href="#rightJustify"><b>rightJustify</b></a> ( uint width, char fill = ' ', bool truncate = FALSE ) const</div></li><li><div class=fn>QCString <a href="#lower"><b>lower</b></a> () const</div></li><li><div class=fn>QCString <a href="#upper"><b>upper</b></a> () const</div></li><li><div class=fn>QCString <a href="#stripWhiteSpace"><b>stripWhiteSpace</b></a> () const</div></li><li><div class=fn>QCString <a href="#simplifyWhiteSpace"><b>simplifyWhiteSpace</b></a> () const</div></li><li><div class=fn>QCString & <a href="#insert-2"><b>insert</b></a> ( uint index, const char * s )</div></li><li><div class=fn>QCString & <a href="#insert"><b>insert</b></a> ( uint index, char c )</div></li><li><div class=fn>QCString & <a href="#append"><b>append</b></a> ( const char * str )</div></li><li><div class=fn>QCString & <a href="#prepend"><b>prepend</b></a> ( const char * s )</div></li><li><div class=fn>QCString & <a href="#remove"><b>remove</b></a> ( uint index, uint len )</div></li><li><div class=fn>QCString & <a href="#replace"><b>replace</b></a> ( uint index, uint len, const char * str )</div></li><li><div class=fn>QCString & <a href="#replace-2"><b>replace</b></a> ( const QRegExp & rx, const char * str )</div></li><li><div class=fn>short <a href="#toShort"><b>toShort</b></a> ( bool * ok = 0 ) const</div></li><li><div class=fn>ushort <a href="#toUShort"><b>toUShort</b></a> ( bool * ok = 0 ) const</div></li><li><div class=fn>int <a href="#toInt"><b>toInt</b></a> ( bool * ok = 0 ) const</div></li><li><div class=fn>uint <a href="#toUInt"><b>toUInt</b></a> ( bool * ok = 0 ) const</div></li><li><div class=fn>long <a href="#toLong"><b>toLong</b></a> ( bool * ok = 0 ) const</div></li><li><div class=fn>ulong <a href="#toULong"><b>toULong</b></a> ( bool * ok = 0 ) const</div></li><li><div class=fn>float <a href="#toFloat"><b>toFloat</b></a> ( bool * ok = 0 ) const</div></li><li><div class=fn>double <a href="#toDouble"><b>toDouble</b></a> ( bool * ok = 0 ) const</div></li><li><div class=fn>QCString & <a href="#setStr"><b>setStr</b></a> ( const char * str )</div></li><li><div class=fn>QCString & <a href="#setNum-2"><b>setNum</b></a> ( short n )</div></li><li><div class=fn>QCString & <a href="#setNum-3"><b>setNum</b></a> ( ushort n )</div></li><li><div class=fn>QCString & <a href="#setNum-4"><b>setNum</b></a> ( int n )</div></li><li><div class=fn>QCString & <a href="#setNum-5"><b>setNum</b></a> ( uint n )</div></li><li><div class=fn>QCString & <a href="#setNum-6"><b>setNum</b></a> ( long n )</div></li><li><div class=fn>QCString & <a href="#setNum-7"><b>setNum</b></a> ( ulong n )</div></li><li><div class=fn>QCString & <a href="#setNum-8"><b>setNum</b></a> ( float n, char f = 'g', int prec = 6 )</div></li><li><div class=fn>QCString & <a href="#setNum"><b>setNum</b></a> ( double n, char f = 'g', int prec = 6 )</div></li><li><div class=fn>bool <a href="#setExpand"><b>setExpand</b></a> ( uint index, char c )</div></li><li><div class=fn><a href="#operator-const-char-*"><b>operator const char *</b></a> () const</div></li><li><div class=fn>QCString & <a href="#operator+-eq"><b>operator+=</b></a> ( const char * str )</div></li><li><div class=fn>QCString & <a href="#operator+-eq-2"><b>operator+=</b></a> ( char c )</div></li></ul><h2>相关函数</h2><ul><li><div class=fn>void * <a href="#qmemmove"><b>qmemmove</b></a> ( void * dst, const void * src, uint len )</div></li><li><div class=fn>char * <a href="#qstrdup"><b>qstrdup</b></a> ( const char * src )</div></li><li><div class=fn>char * <a href="#qstrcpy"><b>qstrcpy</b></a> ( char * dst, const char * src )</div></li><li><div class=fn>char * <a href="#qstrncpy"><b>qstrncpy</b></a> ( char * dst, const char * src, uint len )</div></li><li><div class=fn>int <a href="#qstrcmp"><b>qstrcmp</b></a> ( const char * str1, const char * str2 )</div></li><li><div class=fn>int <a href="#qstrncmp"><b>qstrncmp</b></a> ( const char * str1, const char * str2, uint len )</div></li><li><div class=fn>int <a href="#qstricmp"><b>qstricmp</b></a> ( const char * str1, const char * str2 )</div></li><li><div class=fn>int <a href="#qstrnicmp"><b>qstrnicmp</b></a> ( const char * str1, const char * str2, uint len )</div></li><li><div class=fn>QDataStream & <a href="#operator-lt-lt"><b>operator<<</b></a> ( QDataStream & s, const QCString & str )</div></li><li><div class=fn>QDataStream & <a href="#operator-gt-gt"><b>operator>></b></a> ( QDataStream & s, QCString & str )</div></li><li><div class=fn>bool <a href="#operator-eq-eq"><b>operator==</b></a> ( const QCString & s1, const QCString & s2 )</div></li><li><div class=fn>bool <a href="#operator-eq-eq-2"><b>operator==</b></a> ( const QCString & s1, const char * s2 )</div></li><li><div class=fn>bool <a href="#operator-eq-eq-3"><b>operator==</b></a> ( const char * s1, const QCString & s2 )</div></li><li><div class=fn>bool <a href="#operator!-eq"><b>operator!=</b></a> ( const QCString & s1, const QCString & s2 )</div></li><li><div class=fn>bool <a href="#operator!-eq-2"><b>operator!=</b></a> ( const QCString & s1, const char * s2 )</div></li><li><div class=fn>bool <a href="#operator!-eq-3"><b>operator!=</b></a> ( const char * s1, const QCString & s2 )</div></li><li><div class=fn>bool <a href="#operator-lt"><b>operator<</b></a> ( const QCString & s1, const char * s2 )</div></li><li><div class=fn>bool <a href="#operator-lt-2"><b>operator<</b></a> ( const char * s1, const QCString & s2 )</div></li><li><div class=fn>bool <a href="#operator-lt-eq"><b>operator<=</b></a> ( const QCString & s1, const char * s2 )</div></li><li><div class=fn>bool <a href="#operator-lt-eq-2"><b>operator<=</b></a> ( const char * s1, const QCString & s2 )</div></li><li><div class=fn>bool <a href="#operator-gt"><b>operator></b></a> ( const QCString & s1, const char * s2 )</div></li><li><div class=fn>bool <a href="#operator-gt-2"><b>operator></b></a> ( const char * s1, const QCString & s2 )</div></li><li><div class=fn>bool <a href="#operator-gt-eq"><b>operator>=</b></a> ( const QCString & s1, const char * s2 )</div></li><li><div class=fn>bool <a href="#operator-gt-eq-2"><b>operator>=</b></a> ( const char * s1, const QCString & s2 )</div></li><li><div class=fn>const QCString <a href="#operator+"><b>operator+</b></a> ( const QCString & s1, const QCString & s2 )</div></li><li><div class=fn>const QCString <a href="#operator+-2"><b>operator+</b></a> ( const QCString & s1, const char * s2 )</div></li><li><div class=fn>const QCString <a href="#operator+-3"><b>operator+</b></a> ( const char * s1, const QCString & s2 )</div></li><li><div class=fn>const QCString <a href="#operator+-4"><b>operator+</b></a> ( const QCString & s, char c )</div></li><li><div class=fn>const QCString <a href="#operator+-5"><b>operator+</b></a> ( char c, const QCString & s )</div></li></ul><hr><a name="details"></a><h2>详细描述</h2><p> QCString类提供了一个经典C语言的以零结尾的字符数组（char *）的抽象。<p> QCString继承了<a href="qbytearray.html">QByteArray</a>，后者是被<a href="qmemarray.html">QMemArray</a><char>这样定义的。<p> 因为QCString是一个QMemArray，它使用了带引用计数的<a href="shclass.html">明显共享</a>。<p> 你可以在从不暴露给用户的文本中使用QCString。对于用户可见的文本，你应该使用<a href="qstring.html">QString</a>（它提供<a href="shclass.html#implicit-sharing">隐含共享</a>、Unicode和其它<a href="i18n.html#internationalization">国际化</a>支持。<p> 注意QCString是Qt中比较薄弱的类，它的设计是有缺陷的（它试图在行为上变为更方便的const char *）并且作为结果，QCString使用的所有算法经常执行得很差。例如，因为<a href="#append">append</a>()扫描一个零结束符，所以它是O(length())，这也严重地影响着很多使用QCString的算法。<p> 注意对于使用<tt>const char *</tt>参数的QCString的方法，如果QCString不是以零结尾的，结果是不确定的。<tt>const char *</tt>参数为0是合法的。<p> 没有分配任何事物的QCString是<em>零</em>，也就是长度和数据指针都是0。一个引用空字符串（“”，单一的'\0'字符）的QCString是<em>空</em>。在方法中，零和空QCString都是合法参数。把<tt>const char *</tt> 0分配给QCString就给定了一个零QCString。<p> <a href="#length">length</a>()函数返回字符串的长度，<a href="#resize">resize</a>()重新定义字符串的大小并且<a href="#truncate">truncate</a>()截短字符串。字符串可以使用<a href="#fill">fill</a>()来用一个字符填充。使用<a href="#leftJustify">leftJustify</a>()和<a href="#rightJustify">rightJustify</a>()在字符串的左面或者右面填补字符。使用<a href="#find">find</a>()和<a href="#findRev">findRev</a>()可以搜索字符、字符串和正则表达式，并且使用<a href="#contains">contains</a>()来计数。<p> 字符串和字符可以通过<a href="#insert">insert</a>()来插入并且通过<a href="#append">append</a>()来添加。字符串可以通过<a href="#prepend">prepend</a>()在前面添加。字符串中的字符可以通过<a href="#remove">remove</a>()来移除并且通过<a href="#replace">replace</a>()来替换。<p> 字符串的一部分可以使用<a href="#left">left</a>()、<a href="#right">right</a>()和<a href="#mid">mid</a>()来提取。空白符号可以使用<a href="#stripWhiteSpace">stripWhiteSpace</a>()和<a href="#simplifyWhiteSpace">simplifyWhiteSpace</a>()来移除。字符串可以使用<a href="#upper">upper</a>()和<a href="#lower">lower</a>()分别转换为大写或小写。<p> 包含数字的字符串可以使用<a href="#toShort">toShort</a>()、<a href="#toInt">toInt</a>()、<a href="#toLong">toLong</a>()、<a href="#toULong">toULong</a>()、<a href="#toFloat">toFloat</a>()和<a href="#toDouble">toDouble</a>()来被转换为数字。数字可以使用<a href="#setNum">setNum</a>()来被转换为字符串。<p> 很多操作符被重载以用来为QCString工作。QCString也支持更多的不明显的功能，例如<a href="#sprintf">sprintf</a>()、<a href="#setStr">setStr</a>()和<a href="#setExpand">setExpand</a>()。<p> <a name="asciinotion"></a><blockquote><p align="center"><b> 在字符比较上请注意</b><p><p> 在QCString中，大写和小写的字符大于或者小于另一个依赖于本地的字符。这个影响支持不区分大小写选项的或者比较大写或者小写参数的函数。如果两个字符串都只包含ACSII码，不区分大小写的操作和比较将是正确的。（如果<tt>$LC_CTYPE</tt>被设置，绝大多数Unix系统都会做“正确的事情”。）受这个影响的函数包括<a href="#contains">contains</a>()、<a href="#find">find</a>()、<a href="#findRev">findRev</a>()、<a href="#operator-lt">operator<</a>()、<a href="#operator-lt-eq">operator<=</a>()、<a href="#operator-gt">operator></a>()、<a href="#operator-gt-eq">operator>=</a>()、<a href="#lower">lower</a>()和<a href="#upper">upper</a>()。</blockquote><p><p> 性能注意：使用<a href="qregexp.html">QRegExp</a>进行搜索的QCString方法通过把QCString转换为<a href="qstring.html">QString</a>来重新实现的并且在它上面执行搜索的。这意味着QCString数据的<a href="shclass.html#deep-copy">深复制</a>。如果你要在一个大的QCString中执行许多QRegExp的搜索，你最好自己把QCString转换为QString并且在QString中进行搜索可以得到更好的执行效果。<p>也可以参考<a href="collection.html">集合类</a>、<a href="shared.html">隐含和明显共享类</a>、<a href="text.html">文本相关类</a>和<a href="tools.html">非图形用户界面类</a>。<hr><h2>成员函数文档</h2><h3 class=fn><a name="QCString"></a>QCString::QCString ()</h3>构造一个零字符串。<p>也可以参考<a href="#isNull">isNull</a>()。<h3 class=fn><a name="QCString-2"></a>QCString::QCString ( int size )</h3>构造一个空间为<em>size</em>字符，包括'\0'结尾符的字符串。如果<em>size</em> == 0，这就是一个零字符串。<p> 如果<em>size</em> > 0，那么字符串的第一个和最后一个字符被初始化为'\0'.。所有其它字符没有被初始化。<p> <p>也可以参考<a href="#resize">resize</a>()和<a href="#isNull">isNull</a>()。<h3 class=fn><a name="QCString-3"></a>QCString::QCString ( const <a href="qcstring.html">QCString</a> & s )</h3>构造一个<em>s</em>的<a href="shclass.html#shallow-copy">浅复制</a>。<p>也可以参考<a href="qmemarray.html#assign">assign</a>()。<h3 class=fn><a name="QCString-4"></a>QCString::QCString ( const char * str )</h3>构造一个<em>str</em>的<a href="shclass.html#deep-copy">深复制</a>。<p> 如果<em>str</em>0，那么零字符串被创建。<p> <p>也可以参考<a href="#isNull">isNull</a>()。<h3 class=fn><a name="QCString-5"></a>QCString::QCString ( const char * str, uint maxsize )</h3>构造一个<em>str</em>的<a href="shclass.html#deep-copy">深复制</a>，包括'\0'结尾符不超过<em>maxsize</em>字节。<p> 实例：<pre> QCString str( "helloworld", 6 ); // 把“hello”分配给str </pre> <p> 如果<em>str</em>在开始的<em>maxsize</em>字节中包含一个0字节，那么结果QCString将被这个0结束。如果<em>str</em>0，那么零字符串被创建。<p> <p>也可以参考<a href="#isNull">isNull</a>()。<h3 class=fn><a href="qcstring.html">QCString</a> & <a name="append"></a>QCString::append ( const char * str )</h3>把字符串<em>str</em>添加到字符串末尾并且返回这个字符串的引用。等于<a href="#operator+-eq">operator+=</a>()。<h3 class=fn>int <a name="contains"></a>QCString::contains ( char c, bool cs = TRUE ) const</h3>返回字符串中字符<em>c</em>出现的次数。<p> 如果<em>cs</em>为真，匹配就区分大小写，或者如果<em>cs</em>为假，就不区分大小写。<p> <p>也可以参考<a href="#asciinotion">Note on character comparisons</a>。<h3 class=fn>int <a name="contains-2"></a>QCString::contains ( const char * str, bool cs = TRUE ) const</h3>这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。<p> 返回字符串中<em>str</em>出现的次数。<p> 如果<em>cs</em>为真，匹配就区分大小写，或者如果<em>cs</em>为假，就不区分大小写。⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -