qstring.html

QT参考文档

  </pre>
 
<p> <b>警告：</b>如果你是用<a href="#arg">arg</a>()来构造一个想上面实例中的“真正”的句子，那么这可能导致一些翻译的问题（当你使用tr()函数时）。
<p> 如果没有<tt>%i</tt>模式，一个警告信息（<a href="qapplication.html#qWarning">qWarning</a>()）被输出并且这个文本被添加到字符串的末尾。这被做为错误恢复的功能并且不应该在正确的代码中出现。
<p> <p>也可以参考<a href="qobject.html#tr">QObject::tr</a>()。

<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-2"></a>QString::arg ( long&nbsp;a, int&nbsp;fieldwidth = 0, int&nbsp;base = 10 ) const
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> <em>fieldwidth</em>值指定了填充到<em>a</em>中的最小空间。正值将产生右对齐文本，负值将产生左对齐文本。
<p> <em>a</em>被基于<em>base</em>表示，默认为10，并且必须在2到36之间。
<p> <pre>
    QString str;
    str = <a href="#QString">QString</a>( "Decimal 63 is %1 in hexadecimal" )
          .arg( 63, 0, 16 );
    // str == "Decimal 63 is 3f in hexadecimal"
  </pre>
 

<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-3"></a>QString::arg ( ulong&nbsp;a, int&nbsp;fieldwidth = 0, int&nbsp;base = 10 ) const
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> <em>a</em>被基于<em>base</em>表示，默认为10，并且必须在2到36之间。

<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-4"></a>QString::arg ( int&nbsp;a, int&nbsp;fieldwidth = 0, int&nbsp;base = 10 ) const
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> <em>a</em>被基于<em>base</em>表示，默认为10，并且必须在2到36之间。

<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-5"></a>QString::arg ( uint&nbsp;a, int&nbsp;fieldwidth = 0, int&nbsp;base = 10 ) const
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> <em>a</em>被基于<em>base</em>表示，默认为10，并且必须在2到36之间。

<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-6"></a>QString::arg ( short&nbsp;a, int&nbsp;fieldwidth = 0, int&nbsp;base = 10 ) const
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> <em>a</em>被基于<em>base</em>表示，默认为10，并且必须在2到36之间。

<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-7"></a>QString::arg ( ushort&nbsp;a, int&nbsp;fieldwidth = 0, int&nbsp;base = 10 ) const
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> <em>a</em>被基于<em>base</em>表示，默认为10，并且必须在2到36之间。

<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-8"></a>QString::arg ( char&nbsp;a, int&nbsp;fieldwidth = 0 ) const
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> <em>a</em>被假设在Latin1字符集中。

<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-9"></a>QString::arg ( <a href="qchar.html">QChar</a>&nbsp;a, int&nbsp;fieldwidth = 0 ) const
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-a"></a>QString::arg ( double&nbsp;a, int&nbsp;fieldwidth = 0, char&nbsp;fmt = 'g', int&nbsp;prec = -1 ) const
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> <a name="arg-formats"></a>
<p> 根据<em>fmt</em>指定的格式，参数<em>a</em>被格式化，<tt>g</tt>为默认情况并且可以为下列之一：
<p> <ul>
<li> <tt>e</tt> - 格式化为[-]9.9e[+|-]999
<li> <tt>E</tt> - 格式化为[-]9.9E[+|-]999
<li> <tt>f</tt> - 格式化为[-]9.9
<li> <tt>g</tt> - 使用<tt>e</tt>或<tt>f</tt>格式，看哪一个更简练
<li> <tt>G</tt> - 使用<tt>E</tt>或<tt>f</tt>格式，看哪一个更简练
</ul>
<p> 在所有的情况下，小数点之后数字的个数等于<em>prec</em>指定的精度。
<p> <pre>
    double d = 12.34;
    QString ds = <a href="#QString">QString</a>( "'E' format, precision 3, gives %1" )
                 .arg( d, 0, 'E', 3 );
    // ds == "1.234E+001"
  </pre>
 
<h3 class=fn>const char * <a name="ascii"></a>QString::ascii () const
</h3>
<p> <b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
<p> 这个函数简单的调用<a href="#latin1">latin1</a>()并且返回结果。
<p>实例：<a href="networkprotocol-example.html#x619">network/networkprotocol/nntp.cpp</a>。

<h3 class=fn><a href="qchar.html">QChar</a> <a name="at"></a>QString::at ( uint&nbsp;i ) const
</h3>
<p> 返回在索引<em>i</em>处的字符，或者如果<em>i</em>超过字符串的长度返回0。
<p> <pre>
    const QString string( "abcdefgh" );
    <a href="qchar.html">QChar</a> ch = string.<a href="#at">at</a>( 4 );
    // ch == 'e'
  </pre>
 
<p> 如果QString不是常量（也就是const QString）或者const&（也就是const QString&），那么<a href="#at">at</a>()的非常量重载将被用来替代。

<h3 class=fn><a href="qcharref.html">QCharRef</a> <a name="at-2"></a>QString::at ( uint&nbsp;i )
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 这个函数返回在索引<em>i</em>处的字符的引用。这个结果引用在这之后可以被分配，或者立即使用，但是一旦超过原字符串进行根多的修改，它将会变为无效。
<p> 如果<em>i</em>超过了字符串的长度，那么这个字符串将会被使用QChar::null扩大。

<h3 class=fn>int <a name="compare"></a>QString::compare ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;s1, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;s2 )<tt> [静态]</tt>
</h3> 
<p> 对<em>s1</em>和<em>s2</em>进行词典比较，如果<em>s1</em>小于、等于或者大于<em>s2</em>，就返回小于、等于或者大于0的整数。
<p> 这个比较是专有的基于字符的数字Unicode值并且非常快，但是不是人们所期待的。排序用户界面字符串请考虑使用<a href="#localeAwareCompare">QString::localeAwareCompare</a>()。
<p> <pre>
    int a = QString::<a href="#compare">compare</a>( "def", "abc" );   // a &gt; 0
    int b = QString::<a href="#compare">compare</a>( "abc", "def" );   // b &lt; 0
    int c = QString::<a href="#compare">compare</a>(" abc", "abc" );   // c == 0
  </pre>
 
<h3 class=fn>int <a name="compare-2"></a>QString::compare ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;s ) const
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 对这个字符串和<em>s</em>进行词典比较，如果它小于、等于或者大于<em>s</em>，就返回小于、等于或者大于0的整数。

<h3 class=fn>void <a name="compose"></a>QString::compose ()
</h3>
注意这个函数在Qt 3.0中不被支持并且仅仅用于实验和说明目的。它主要是关注于阿拉伯的和其它多成分文本的实验。
<p> 适用于可能带连字的QString。当多成分文本需要表现缺乏象形字的字体时非常有用，但是它也可以制造像<a href="qchar.html">QChar</a>(0x0041)（'A'）和QChar(0x0308)（Unicode accent diaresis），给定的QChar(0x00c4)（德语的A元音变音）。

<h3 class=fn><a href="qchar.html">QChar</a> <a name="constref"></a>QString::constref ( uint&nbsp;i ) const
</h3>
<p> 返回在索引<em>i</em>处的<a href="qchar.html">QChar</a>的值。
<p> 等于<a href="#at">at</a>(<em>i</em>)。
<p> <p>也可以参考<a href="#ref">ref</a>()。

<h3 class=fn>int <a name="contains"></a>QString::contains ( <a href="qchar.html">QChar</a>&nbsp;c, bool&nbsp;cs = TRUE ) const
</h3>
返回在这个字符串中字符<em>c</em>出现的次数。
<p> 如果<em>cs</em>为真，那么匹配是区分大小写的。如果<em>cs</em>为假，那么匹配是不区分大小写的。
<p> <pre>
    QString string( "Trolltech and Qt" );
    int i = string.<a href="#contains">contains</a>( 't', FALSE );  // i == 3
  </pre>
 
<p>实例：<a href="fileiconview-example.html#x865">fileiconview/qfileiconview.cpp</a>和<a href="mdi-example.html#x2037">mdi/application.cpp</a>。

<h3 class=fn>int <a name="contains-2"></a>QString::contains ( char&nbsp;c, bool&nbsp;cs = TRUE ) const
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

<h3 class=fn>int <a name="contains-3"></a>QString::contains ( const&nbsp;char&nbsp;*&nbsp;str, bool&nbsp;cs = TRUE ) const
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 返回在这个字符串中字符串<em>str</em>出现的次数。
<p> 如果<em>cs</em>为真，那么匹配是区分大小写的。如果<em>cs</em>为假，那么匹配是不区分大小写的。

<h3 class=fn>int <a name="contains-4"></a>QString::contains ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;str, bool&nbsp;cs = TRUE ) const
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 返回在这个字符串中<em>str</em>出现的次数。
<p> 如果<em>cs</em>为真，那么匹配是区分大小写的。如果<em>cs</em>为假，那么匹配是不区分大小写的。
<p> 这个函数计算重叠的字符串，所以在下面的实例中，“bananas”中有两个“ana”的实例。
<p> <pre>
    QString str( "bananas" );
    int i = str.<a href="#contains">contains</a>( "ana" );  // i == 2
  </pre>
 
<p> <p>也可以参考<a href="#findRev">findRev</a>()。

<h3 class=fn>int <a name="contains-5"></a>QString::contains ( const&nbsp;<a href="qregexp.html">QRegExp</a>&nbsp;&amp;&nbsp;rx ) const
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 返回在字符串中正则表达式<em>rx</em>出现的次数。
<p> 这个函数计算重叠的字符串，所以在下面的实例中，有四个“ana”或者“ama”的实例。
<p> <pre>
    QString str = "banana and panama";
    <a href="qregexp.html">QRegExp</a> rxp = QRegExp( "a[nm]a", TRUE, FALSE );
    int i = str.<a href="#contains">contains</a>( rxp );    // i == 4