libcdos-fw
CFString类 参考

CFString 字符串类. 更多...

#include <CFString.h>

Public 成员函数

 CFString ()
 默认构造函数.
 
 CFString (const CFChar *str)
 构造函数. 更多...
 
 CFString (const CFUChar *str)
 构造函数. 更多...
 
 CFString (const CFString &other)
 拷贝构造函数. 更多...
 
CFUInt clength ()
 获取C字符串长度. 更多...
 
CFInt compare (const CFString &other)
 比较字符串和 other 字符串. 更多...
 
void display ()
 
bool equal (const CFString &other)
 判断字符串是否与 other 字符串相同. 更多...
 
CFInt indexOf (CFUChar chr, int from=0, bool caseSensitive=true)
 字符串查找. 更多...
 
CFInt indexOf (const CFString &str, int from=0, bool caseSensitive=true)
 字符串查找. 更多...
 
bool isEmpty () const
 判断是否为空字符串. 更多...
 
bool isUtf8 () const
 判断是否包含UTF-8编码的字符. 更多...
 
CFUInt length ()
 获取字符串长度. 更多...
 
bool operator!= (const CFString &other)
 
CFStringoperator+= (const CFString &str1)
 
bool operator< (const CFString &other)
 
bool operator<= (const CFString &other)
 
CFStringoperator= (const CFString &str1)
 
bool operator== (const CFString &other)
 
bool operator> (const CFString &other)
 
bool operator>= (const CFString &other)
 
CFStringList split (const CFString &splitStr)
 字符串分割. 更多...
 
CFString sub (CFUInt pos, CFInt len)
 字符串截取. 更多...
 
char * toCString ()
 获取C语言字符串. 更多...
 
std::string toStdString ()
 获取C++标准库字符串. 更多...
 
CFUChar * toUtf8 ()
 获取UTF-8编码字符串. 更多...
 
 ~CFString ()
 析构函数. 更多...
 

友元

CFString operator+ (const CFString &str1, const CFString &str2)
 
CFString operator+ (const CFString &str1, const CFUChar *str2)
 
CFString operator+ (const CFUChar *str1, const CFString &str2)
 
CFString operator+ (const CFString &str1, const CFChar *str2)
 
CFString operator+ (const CFChar *str1, const CFString &str2)
 

详细描述

CFString 字符串类.

CFString是字符串类,用于处理各种字符串相关操作; 其中包括但不限于: 字符串读取 字符串连接 字符串截取 字符串分割 字符串查找 字符串比较

构造及析构函数说明

§ CFString() [1/3]

CFString::CFString ( const CFChar *  str)

构造函数.

参数
[in]str以'\0'结尾的C语言格式字符串,可以包含中文。
参见
CFString(const CFUChar* str);

§ CFString() [2/3]

CFString::CFString ( const CFUChar *  str)

构造函数.

参数
[in]str以'\0'结尾的C语言格式字符串,可以包含中文。
参见
CFString(const CFChar* str);

§ CFString() [3/3]

CFString::CFString ( const CFString other)

拷贝构造函数.

参数
[in]other另一个CFString类实例。

§ ~CFString()

CFString::~CFString ( )

析构函数.

在字符串被销毁时会被自动调用。 在析构函数中进行内存释放等操作。

成员函数说明

§ clength()

CFUInt CFString::clength ( )

获取C字符串长度.

获取字符串的字节长度,不考虑编码。

返回
字符串的字节长度。
参见
length();

§ compare()

CFInt CFString::compare ( const CFString other)

比较字符串和 other 字符串.

参数
[in]other需要与之比较的字符串。
返回
0 为与other字符串相同。
>0 则字符串大于 other 字符串。
<0 则字符串小于 other 字符串。
参见
equal()

§ equal()

bool CFString::equal ( const CFString other)

判断字符串是否与 other 字符串相同.

参数
[in]other需要与之比较的字符串。
返回
是否与 other 字符串相同,true为相同,否则为不同。
参见
compare()

§ indexOf() [1/2]

CFInt CFString::indexOf ( CFUChar  chr,
int  from = 0,
bool  caseSensitive = true 
)

字符串查找.

从 from 位置开始查找 chr 字符,caseSensitive参数表示是否区分大小写。

参数
[in]chr需要查找的字符。
[in]from起始位置,默认为0。
[in]caseSensitive是否区分大小写,区分大小写为true,否则为false,默认区分大小写.
返回
返回chr字符第一次找到的位置,返回-1表示未找到chr。

§ indexOf() [2/2]

CFInt CFString::indexOf ( const CFString str,
int  from = 0,
bool  caseSensitive = true 
)

字符串查找.

从 from 位置开始查找 str 字符串,caseSensitive参数表示是否区分大小写。

参数
[in]str需要查找的字符串(可以包含UTF-8字符)。
[in]from起始位置,默认为0。
[in]caseSensitive是否区分大小写,区分大小写为true,否则为false,默认区分大小写.
返回
返回str字符串第一次找到的位置,返回-1表示未找到str字符串。

§ isEmpty()

bool CFString::isEmpty ( ) const

判断是否为空字符串.

返回
是否为空字符串,true为空字符串,否则为非空字符串。

§ isUtf8()

bool CFString::isUtf8 ( ) const

判断是否包含UTF-8编码的字符.

返回
是否包含UTF-8编码的字符,true为包含UTF-8字符,否则为不包含。

§ length()

CFUInt CFString::length ( )

获取字符串长度.

获取字符串的字长度,考虑编码(目前只支持ASCII与UTF-8编码),因此中文中一个汉字长度为1。

返回
字符串中字符的个数。
参见
clength();

§ split()

CFStringList CFString::split ( const CFString splitStr)

字符串分割.

使用参数splitStr来对字符串进行分割,并生成一个字符串数组返回给调用者。

参数
[in]splitStr用以分割字符串的分割符,可以是包含多个字符的字符串,也可以是只有单个字符的字符串,可以包含UTF-8字符。
返回
通过splitStr分割后生成的字符串列表。

§ sub()

CFString CFString::sub ( CFUInt  pos,
CFInt  len 
)

字符串截取.

从 pos 位置开始截取 len 个字符,并将该字符串返回给调用者。

参数
[in]pos需要截取字符串的起始位置,范围:0~length(), 一个UTF-8字符算一个字符。
[in]len需要截取字符串的长度,一个UTF-8字符算一个字符,若需要截取 pos 后的全部字符串,则传入 -1 .
返回
截取操作后的字符串。

§ toCString()

char* CFString::toCString ( )

获取C语言字符串.

获取C语言字符串。

返回
C语言字符串。
参见
toStdString();
toUtf8();

§ toStdString()

std::string CFString::toStdString ( )

获取C++标准库字符串.

获取C++标准库字符串。

返回
C++标准库字符串。
参见
toCString();
toUtf8();

§ toUtf8()

CFUChar* CFString::toUtf8 ( )

获取UTF-8编码字符串.

获取UTF-8编码字符串。

返回
UTF-8编码字符串。
参见
toCString();
toStdString();

该类的文档由以下文件生成: