QString 类

http://www.cnblogs.com/Braveliu/category/441585.html

QString类提供了一个Unicode文本和经典的C以零结尾的字符数组的抽象。

 

（1）QString::QString()

构造一个零字符串。这是一个不被分配任何东西的字符串，也就是说长度和数据指针都为0。如何理解？请看下面这个成员函数。

 

（2）bool QString::isNull() const

如果字符串为零，返回真。零字符串总是空的。

1 QString a;          // a.unicode() == 0，a.length() == 0
2 a.isNull();         // 真，因为a.unicode() == 0
3 a.isEmpty();        // 真

 

（3）bool QString::isEmpty() const

如果字符串为空，也就是如果length() == 0，返回真。因此，零字符串也是空字符串。

1 QString a("");
2 a.isEmpty();        // 真
3 a.isNull();         // 假
4 
5 QString b;
6 b.isEmpty();        // 真
7 b.isNull();         // 真

 

（4）uint QString::length() const

返回字符串的长度。

零字符串和空字符串的长度都为0。

 

（5）QString & QString::append(const QString & str)

把str添加到字符串中并且返回结果的引用。

1 QString string = "Test";
2 string.append( "ing" );        // string == "Testing"

 

（6）QString QString::arg(const QString & a, int fieldwidth = 0) const

这个函数将返回使用a来替换最低层出现的%i（i为'1'或'2'或……'9'）的字符串。

fieldwidth值指定了填充到a中的最小空间。正值将产生右对齐文本，负值将产生左对齐文本。

1 QString firstName( "liu" );
2 QString lastName( "yong" );
3 QString fullName;
4 fullName = QString( "First name is '%1', last name is '%2'" )
5      .arg( firstName )
6      .arg( lastName );
7 
8  // fullName == First name is 'liu', last name is 'yong'

 

（7）QChar QString::at(uint i) const

返回在索引i处的字符，或者如果i超过字符串的长度返回0。

1     const QString string( "abcdefgh" );
2     QChar ch = string.at( 4 );
3     // ch == 'e'

 

（8）int QString::compare(const QString & s1, const QString & s2)  [静态]

对s1和s2进行词典比较，如果s1小于、等于或者大于s2，就返回小于、等于或者大于0的整数。

这个比较是专有的基于字符的数字Unicode值并且非常快，但是不是人们所期待的。排序用户界面字符串请考虑使用QString::localeAwareCompare()。

1     int a = QString::compare( "def", "abc" );   // a > 0
2     int b = QString::compare( "abc", "def" );   // b < 0
3     int c = QString::compare(" abc", "abc" );   // c == 0

 

（9）int QString::contains(QChar c, bool cs = TRUE) const

返回在这个字符串中字符c出现的次数。

如果cs为真，那么匹配是区分大小写的。如果cs为假，那么匹配是不区分大小写的。

1     QString string( "Trolltech and Qt" );
2     int i = string.contains( 't', FALSE );  // i == 3

 

（10）bool QString::startsWith(const QString & s) const

如果字符串以s开始，返回真，否则返回假。

1     QString string("Bananas");
2     bool a = string.startsWith("Ban");      //  a == TRUE

 

（11）QString & QString::fill(QChar c, int len = -1 )

填充字符串为len个字符的值c，并且返回字符串的引用。

如果len为负数（默认），当前字符串长度被使用。

1     QString str;
2     str.fill( 'g', 5 );      // string == "ggggg"

 

（12）int QString::find(const QRegExp & rx, int index = 0) const

从位置index开始，找到常量正则表达式rx第一次出现的位置。如果index为-1，搜索从最后一个字符开始，如果是-1，从紧挨着最后一个字符的字符开始，依此类推。

返回rx第一次出现的位置，如果rx没有被找到，返回-1。

1     QString string( "bananas" );
2     int i = string.find( QRegExp("an"), 0 );    // i == 1

 

（13）QString & QString::insert(uint index, const QString & s)

把s插入到字符串的index位置之前。

如果index超过字符串的结尾，字符串被填充空格扩展到index长度并且然后s被添加，返回这个字符串的引用。

1     QString string( "I like fish" );
2     str = string.insert( 2, "don't " );
3     // str == "I don't like fish"

 

（14）QString QString::left(uint len) const

返回包含字符串最左面的len个字符的子字符串。

如果len超过字符串的长度，则整个字符串被返回。

1     QString s = "Pineapple";
2     QString t = s.left( 4 );    // t == "Pine"

 

（15）int QString::localeAwareCompare(const QString & s1, const QString & s2) [静态]

对s1和s2进行比较，如果s1小于、等于或者大于s2，就返回小于、等于或者大于0的整数。

这个比较是基于本地的并且也是基于平台的方式。使用这个函数可以把排好序的字符串列表呈现给用户。

 

（16）QString QString::lower() const

返回由这个字符串转换的小写字符串。

1     QString string( "TROlltECH" );
2     str = string.lower();   // str == "trolltech"

 

（17）QString QString::number (long n, int base = 10) [静态]

一个把数字n转换为字符串的方便函数，n被基于base表示，默认为10，并且必须在2到36之间。

1     long a = 63;
2     QString str = QString::number( a, 16 );             // str == "3f"
3     QString str = QString::number( a, 16 ).upper();     // str == "3F"

 

（18）QString & QString::setNum(long n, int base = 10)

设置字符串为打印的数据n，n是基于base并且返回这个字符串的引用。

base默认为10并且必须在2到36之间。

1     QString string;
2     string = string.setNum( 1234 );     // string == "1234"

 

（19）int QString::toInt(bool *ok = 0, int base =10) const

返回由这个字符串转化的int值，是基于base的，默认为10并且必须在2到36之间。

如果转化发生错误，*ok被设置为假（除非ok为0，这是默认的）并且0被返回。否则*ok被设置为真。

1     QString str( "FF" );
2     bool ok;
3     int hex = str.toInt( &ok, 16 );     // hex == 255, ok == TRUE
4     int dec = str.toInt( &ok, 10 );     // dec == 0, ok == FALSE

 

（20）QString QString::trimmed() const

移除字符串两端的空白字符。

1     QString str = "  lots\t of\nwhitespace\r\n ";
2     str = str.trimmed();
3     // str == "lots\t of\nwhitespace"