qcstring.html

QT3的教程

<p> 这个函数对子字符串重叠计数，例如，“banana”包含两个“ana”。
<p> <p>也可以参考<a href="#findRev">findRev</a>()和<a href="#asciinotion">Note on character comparisons</a>。

<h3 class=fn>int <a name="contains-3"></a>QCString::contains ( const&nbsp;<a href="qregexp.html">QRegExp</a>&nbsp;&amp;&nbsp;rx ) const
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 字符串中<em>rx</em>出现的重叠计数。
<p> 实例：
<pre>
    <a href="qstring.html">QString</a> s = "banana and panama";
    <a href="qregexp.html">QRegExp</a> r = QRegExp( "a[nm]a", TRUE, FALSE );
    s.<a href="qstring.html#contains">contains</a>( r ); // 4个匹配项
  </pre>
 
<p> <p>也可以参考<a href="#find">find</a>()和<a href="#findRev">findRev</a>()。

<h3 class=fn><a href="qcstring.html">QCString</a> <a name="copy"></a>QCString::copy () const
</h3>
返回这个字符串的<a href="shclass.html#deep-copy">深复制</a>。
<p>也可以参考<a href="qmemarray.html#detach">detach</a>()。

<h3 class=fn>bool <a name="fill"></a>QCString::fill ( char&nbsp;c, int&nbsp;len = -1 )
</h3>
在字符串中填充<em>len</em>个字节的字符<em>c</em>和一个'&#92;0'结束符。
<p> 如果<em>len</em>为负数，那么当前的字符串长度被使用。
<p> 返回假就是<em>len</em>为非负数并且没有足够的空间来重新定义字符串的大小，否则就返回真。

<h3 class=fn>int <a name="find"></a>QCString::find ( char&nbsp;c, int&nbsp;index = 0, bool&nbsp;cs = TRUE ) const
</h3>
在字符串中从<em>index</em>位置开始，找到字符<em>c</em>第一次出现的位置。
<p> 如果<em>cs</em>为真，搜索是区分大小写的，否则如果<em>cs</em>为假，就不区分大小写。
<p> 返回<em>c</em>的位置，或者如果<em>c</em>没有被发现，返回-1。
<p> <p>也可以参考<a href="#asciinotion">Note on character comparisons</a>。
<p>实例：<a href="networkprotocol-example.html#x592">network/networkprotocol/nntp.cpp</a>。

<h3 class=fn>int <a name="find-2"></a>QCString::find ( const&nbsp;char&nbsp;*&nbsp;str, int&nbsp;index = 0, bool&nbsp;cs = TRUE ) const
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 在字符串中从<em>index</em>位置开始，找到字符串<em>str</em>第一次出现的位置。
<p> 如果<em>cs</em>为真，搜索是区分大小写的，否则如果<em>cs</em>为假，就不区分大小写。
<p> 返回<em>str</em>的位置，或者如果<em>str</em>没有被发现，返回-1。
<p> <p>也可以参考<a href="#asciinotion">Note on character comparisons</a>。

<h3 class=fn>int <a name="find-3"></a>QCString::find ( const&nbsp;<a href="qregexp.html">QRegExp</a>&nbsp;&amp;&nbsp;rx, int&nbsp;index = 0 ) const
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 在字符串中从<em>index</em>位置开始，找到<a href="qregexp.html#regular-expression">正则表达式</a><em>rx</em>第一次出现的位置。
<p> 返回下一个匹配的位置，如果<em>rx</em>没有被发现，返回-1。

<h3 class=fn>int <a name="findRev"></a>QCString::findRev ( char&nbsp;c, int&nbsp;index = -1, bool&nbsp;cs = TRUE ) const
</h3>
在字符串中从<em>index</em>位置开始并且反向搜索，找到字符<em>c</em>第一次出现的位置。
<p> 如果<em>cs</em>为真，搜索是区分大小写的，否则如果<em>cs</em>为假，就不区分大小写。
<p> 返回<em>c</em>的位置，或者如果<em>c</em>没有被发现，返回-1。
<p> <p>也可以参考<a href="#asciinotion">Note on character comparisons</a>。

<h3 class=fn>int <a name="findRev-2"></a>QCString::findRev ( const&nbsp;char&nbsp;*&nbsp;str, int&nbsp;index = -1, bool&nbsp;cs = TRUE ) const
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 在字符串中从<em>index</em>位置开始并且反向搜索，找到字符串<em>str</em>第一次出现的位置。
<p> 如果<em>cs</em>为真，搜索是区分大小写的，否则如果<em>cs</em>为假，就不区分大小写。
<p> 返回<em>str</em>的位置，或者如果<em>str</em>没有被发现，返回-1。
<p> <p>也可以参考<a href="#asciinotion">Note on character comparisons</a>。

<h3 class=fn>int <a name="findRev-3"></a>QCString::findRev ( const&nbsp;<a href="qregexp.html">QRegExp</a>&nbsp;&amp;&nbsp;rx, int&nbsp;index = -1 ) const
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 在字符串中从<em>index</em>位置开始并且反向搜索，找到<a href="qregexp.html#regular-expression">正则表达式</a><em>rx</em>第一次出现的位置。
<p> 返回下一个匹配的位置（反向），如果<em>rx</em>没有被发现，返回-1。

<h3 class=fn><a href="qcstring.html">QCString</a>&nbsp;&amp; <a name="insert"></a>QCString::insert ( uint&nbsp;index, char&nbsp;c )
</h3>
在字符串的<em>index</em>位置插入字符<em>c</em>并且返回字符串的引用。
<p> 如果<em>index</em>超出字符串的结尾，字符串被使用空格（ASCII 32）延伸到<em>index</em>长度，然后<em>c</em>被添加。
<p> 实例：
<pre>
    QCString s = "Yes";
    s.<a href="#insert">insert</a>( 3, '!');                          // s == "Yes!"
  </pre>
 
<p> <p>也可以参考<a href="#remove">remove</a>()和<a href="#replace">replace</a>()。

<h3 class=fn><a href="qcstring.html">QCString</a>&nbsp;&amp; <a name="insert-2"></a>QCString::insert ( uint&nbsp;index, const&nbsp;char&nbsp;*&nbsp;s )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 在字符串的<em>index</em>位置插入字符串<em>s</em>并且返回字符串的引用。
<p> 如果<em>index</em>超出字符串的结尾，字符串被使用空格（ASCII 32）延伸到<em>index</em>长度，然后<em>s</em>被添加。
<p> <pre>
    QCString s = "I like fish";
    s.<a href="#insert">insert</a>( 2, "don't "); // s == "I don't like fish"

    s = "x";                // index 01234
    s.<a href="#insert">insert</a>( 3, "yz" );    // s == "x  yz"
  </pre>
 
<h3 class=fn>bool <a name="isEmpty"></a>QCString::isEmpty () const
</h3>
<p> 如果字符串为空，例如如果<a href="#length">length</a>() == 0，返回真。空字符串不总是零字符串。
<p> 请参考<a href="#isNull">isNull</a>()中的实例。
<p> <p>也可以参考<a href="#isNull">isNull</a>()、<a href="#length">length</a>()和<a href="qmemarray.html#size">size</a>()。

<h3 class=fn>bool <a name="isNull"></a>QCString::isNull () const
</h3>
如果字符串为零，例如如果<a href="qmemarray.html#data">data</a>() == 0，返回真。零字符串也是空字符串。
<p> 实例：
<pre>
    QCString a;         // a.<a href="qmemarray.html#data">data</a>() == 0,  a.<a href="qmemarray.html#size">size</a>() == 0, a.<a href="#length">length</a>() == 0
    QCString b == "";   // b.<a href="qmemarray.html#data">data</a>() == "", b.<a href="qmemarray.html#size">size</a>() == 1, b.<a href="#length">length</a>() == 0
    a.<a href="#isNull">isNull</a>();         // TRUE，因为a.<a href="qmemarray.html#data">data</a>() == 0
    a.<a href="#isEmpty">isEmpty</a>();        // TRUE，因为a.<a href="#length">length</a>() == 0
    b.<a href="#isNull">isNull</a>();         // FALSE，因为 b.<a href="qmemarray.html#data">data</a>() == ""
    b.<a href="#isEmpty">isEmpty</a>();        // TRUE，因为b.<a href="#length">length</a>() == 0
  </pre>
 
<p> <p>也可以参考<a href="#isEmpty">isEmpty</a>()、<a href="#length">length</a>()和<a href="qmemarray.html#size">size</a>()。

<h3 class=fn><a href="qcstring.html">QCString</a> <a name="left"></a>QCString::left ( uint&nbsp;len ) const
</h3>
返回包含字符串最左面的<em>len</em>个字符的子字符串。
<p> 如果<em>len</em>超过字符串的长度，则整个字符串被返回。
<p> 实例：
<pre>
    QCString s = "Pineapple";
    QCString t = s.<a href="#left">left</a>( 4 );                   // t == "Pine"
  </pre>
 
<p> <p>也可以参考<a href="#right">right</a>()和<a href="#mid">mid</a>()。
<p>实例：<a href="networkprotocol-example.html#x593">network/networkprotocol/nntp.cpp</a>。

<h3 class=fn><a href="qcstring.html">QCString</a> <a name="leftJustify"></a>QCString::leftJustify ( uint&nbsp;width, char&nbsp;fill = ' ', bool&nbsp;truncate = FALSE ) const
</h3>
返回一个长度为<em>width</em>的（为了结束符'&#92;0'加一），包含这个字符串，并且用<em>fill</em>填补的字符串。
<p> 如果<em>truncate</em>为假并且字符串的长度超过<em>width</em>，那么返回的字符串是这个字符串的复制。
<p> 如果<em>truncate</em>为真并且字符串的长度超过<em>width</em>，那么返回的字符串是<a href="#left">left</a>(<em>width</em>)。
<p> 实例：
<pre>
    QCString s("apple");
    QCString t = s.<a href="#leftJustify">leftJustify</a>(8, '.');         // t == "apple..."
  </pre>
 
<p> <p>也可以参考<a href="#rightJustify">rightJustify</a>()。

<h3 class=fn>uint <a name="length"></a>QCString::length () const
</h3>
返回字符串的长度，除了'&#92;0'结束符。等于<tt>strlen(data())</tt>。
<p> 零字符串和空字符串长度都为零。
<p> <p>也可以参考<a href="qmemarray.html#size">size</a>()、<a href="#isNull">isNull</a>()和<a href="#isEmpty">isEmpty</a>()。
<p>实例：<a href="networkprotocol-example.html#x594">network/networkprotocol/nntp.cpp</a>。

<h3 class=fn><a href="qcstring.html">QCString</a> <a name="lower"></a>QCString::lower () const
</h3>
返回由这个字符串转换的小写字符串。
<p> 实例：
<pre>
    QCString s("Credit");
    QCString t = s.<a href="#lower">lower</a>();                     // t == "credit"
  </pre>
 
<p> <p>也可以参考<a href="#upper">upper</a>()和<a href="#asciinotion">Note on character comparisons</a>。

<h3 class=fn><a href="qcstring.html">QCString</a> <a name="mid"></a>QCString::mid ( uint&nbsp;index, uint&nbsp;len = 0xffffffff ) const
</h3>
返回包含这个字符串从<em>index</em>位置开始<em>len</em>个字符的字符串。
<p> 如果这个字符串为空或者<em>index</em>超出范围，返回零。如果<em>index+len</em>超过这个字符串的长度，返回从<em>index</em>开始的整个字符串。
<p> 实例：
<pre>
    QCString s = "Two pineapples";
    QCString t = s.<a href="#mid">mid</a>( 4, 3 );                 // t == "pin"
  </pre>
 
<p> <p>也可以参考<a href="#left">left</a>()和<a href="#right">right</a>()。
<p>实例：<a href="networkprotocol-example.html#x595">network/networkprotocol/nntp.cpp</a>。

<h3 class=fn><a name="operator-const-char-*"></a>QCString::operator const char * () const
</h3>
返回字符串数据。

<h3 class=fn><a href="qcstring.html">QCString</a>&nbsp;&amp; <a name="operator+-eq"></a>QCString::operator+= ( const&nbsp;char&nbsp;*&nbsp;str )
</h3>
把<em>str</em>添加到字符串中并且返回结果的引用。

<h3 class=fn><a href="qcstring.html">QCString</a>&nbsp;&amp; <a name="operator+-eq-2"></a>QCString::operator+= ( char&nbsp;c )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 把字符<em>c</em>添加到字符串中并且返回结果的引用。

<h3 class=fn><a href="qcstring.html">QCString</a>&nbsp;&amp; <a name="operator-eq"></a>QCString::operator= ( const&nbsp;<a href="qcstring.html">QCString</a>&nbsp;&amp;&nbsp;s )
</h3>
把<em>s</em>的一个<a href="shclass.html#shallow-copy">浅度复制</a>赋值给这个字符串并且返回这个字符串的引用。

<h3 class=fn><a href="qcstring.html">QCString</a>&nbsp;&amp; <a name="operator-eq-2"></a>QCString::operator= ( const&nbsp;char&nbsp;*&nbsp;str )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 把<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 href="qcstring.html">QCString</a>&nbsp;&amp; <a name="prepend"></a>QCString::prepend ( const&nbsp;char&nbsp;*&nbsp;s )
</h3>
<p> 在字符串开始处插入<em>s</em>并且返回这个字符串的引用。
<p> <p>也可以参考<a href="#insert">insert</a>()。

<h3 class=fn><a href="qcstring.html">QCString</a>&nbsp;&amp; <a name="remove"></a>QCString::remove ( uint&nbsp;index, uint&nbsp;len )
</h3>
从字符串中的<em>index</em>位置开始移除<em>len</em>个字符并且返回这个字符串的引用。
<p> 如果<em>index</em>超出字符串的长度，就什么也不发生。如果<em>index</em>在字符串中间，但是<em>index</em>加上<em>len</em>超过字符串的结尾，这个字符串将从<em>index</em>开始被截短。
<p> <pre>
    QCString s = "Montreal";
    s.<a href="#remove">remove</a>( 1, 4 );