|
Foxit PDF SDK
|
字节字符串类 更多...
继承自 CFX_Object .
Public 成员函数 | |
| CFX_ByteString () | |
| 构造一个空的字节字符串。 | |
| CFX_ByteString (const CFX_ByteString &str) | |
| 复制构造函数。 更多... | |
| CFX_ByteString (char ch) | |
| 从单个字符构造。 更多... | |
| CFX_ByteString (FX_LPCSTR ptr, FX_STRSIZE len=-1) | |
| 从字符字符串构造。 更多... | |
| CFX_ByteString (FX_LPCBYTE ptr, FX_STRSIZE len) | |
| 从字节字符串构造。 更多... | |
| CFX_ByteString (FX_BSTR bstrc) | |
| 从CFX_ByteStringC对象的常量引用构造。 更多... | |
| CFX_ByteString (FX_BSTR bstrc1, FX_BSTR bstrc2) | |
| 连接构造函数。 更多... | |
| ~CFX_ByteString () | |
| int | Compare (FX_BSTR str) const |
| 将字符串与另一个字符串进行比较。区分大小写。 更多... | |
| void | ConvertFrom (const CFX_WideString &str, CFX_CharMap *pCharMap=NULL) |
| 使用指定的字符映射器将unicode数据加载到此字节字符串中。 如果未指定字符映射器,将使用系统默认映射器。 更多... | |
| FX_STRSIZE | Delete (FX_STRSIZE index, FX_STRSIZE count=1) |
| 从指定位置开始删除一个或多个字符。 更多... | |
| void | Empty () |
| 将此字符串设置为空。 更多... | |
| bool | Equal (FX_BSTR str) const |
| 检查当前字符串是否等于另一个字符串。区分大小写。 更多... | |
| bool | EqualNoCase (FX_BSTR str) const |
| 检查当前字符串是否等于另一个字符串,不考虑大小写。 更多... | |
| FX_STRSIZE | Find (FX_BSTR lpszSub, FX_STRSIZE start=0) const |
| 从指定位置查找子字符串。仅找到第一次出现的位置。 更多... | |
| FX_STRSIZE | Find (FX_CHAR ch, FX_STRSIZE start=0) const |
| 从指定位置查找字符。仅找到第一次出现的位置。 更多... | |
| void | Format (FX_LPCSTR lpszFormat,...) |
| 将一些参数格式化到此字节字符串中。 更多... | |
| void | FormatV (FX_LPCSTR lpszFormat, va_list argList) |
| 使用va_list将一些参数格式化到此字节字符串中。 更多... | |
| FX_BYTE | GetAt (FX_STRSIZE nIndex) const |
| 获取由索引号指定的单个字节。 更多... | |
| FX_LPSTR | GetBuffer (FX_STRSIZE len) |
| 获取分配了指定字节数的缓冲区。 更多... | |
| FX_DWORD | GetID (FX_STRSIZE start_pos=0) const |
| 获取字符串的DWORD标识符。有关详细信息,请参阅函数CFX_ByteStringC::GetID。 更多... | |
| FX_STRSIZE | GetLength () const |
| 获取字节字符串中的字节数(不计算任何可能的终止符)。 更多... | |
| FX_STRSIZE | Insert (FX_STRSIZE index, FX_CHAR ch) |
| 在指定位置之前插入字符。 更多... | |
| bool | IsEmpty () const |
| 检查当前字符串对象是否为空。 更多... | |
| CFX_ByteString | Left (FX_STRSIZE count) const |
| 从此CFX_ByteString对象中提取第一个(最左边)count个字节作为子字符串。 更多... | |
| void | Load (FX_LPCBYTE str, FX_STRSIZE len) |
| 从字节字符串加载。 更多... | |
| FX_LPSTR | LockBuffer () |
| 锁定并获取当前字符串缓冲区,以便调用者可以修改返回的缓冲区。 更多... | |
| void | MakeLower () |
| 将英文字母的大小写更改为小写。 更多... | |
| void | MakeUpper () |
| 将英文字母的大小写更改为大写。 更多... | |
| CFX_ByteString | Mid (FX_STRSIZE first) const |
| 从此CFX_ByteString对象中提取子字符串,从位置nFirst(基于零)开始到最后。 更多... | |
| CFX_ByteString | Mid (FX_STRSIZE first, FX_STRSIZE count) const |
| 从此CFX_ByteString对象中提取count个字节的子字符串,从位置nFirst(基于零)开始到最后。 更多... | |
| bool | operator != (FX_LPCSTR str) const |
| 比较(!=)运算符重载。区分大小写。 更多... | |
| bool | operator != (FX_BSTR str) const |
| 比较(!=)运算符重载。区分大小写。 更多... | |
| bool | operator != (const CFX_ByteString &str) const |
| 比较(!=)运算符重载。区分大小写。 更多... | |
| operator FX_LPCBYTE () const | |
| FX_LPCBYTE类型转换操作符。CFX_ByteString可以在需要FX_LPCSTR或FX_LPCBYTE的地方使用。 | |
| operator FX_LPCSTR () const | |
| FX_LPCSTR类型转换操作符。CFX_ByteString可以在需要FX_LPCSTR或FX_LPCBYTE的地方使用。 | |
| const CFX_ByteString & | operator+= (FX_CHAR ch) |
| 连接(+=)运算符重载。连接单个字符。 更多... | |
| const CFX_ByteString & | operator+= (FX_LPCSTR str) |
| 连接(+=)运算符重载。连接以空字符结尾的字符串。 更多... | |
| const CFX_ByteString & | operator+= (const CFX_ByteString &str) |
| 连接(+=)运算符重载。连接CFX_ByteString对象。 更多... | |
| const CFX_ByteString & | operator+= (FX_BSTR bstrc) |
| 连接(+=)运算符重载。连接常量CFX_ByteStringC对象。 更多... | |
| bool | operator< (const CFX_ByteString &rhs) const |
| 比较(<)运算符重载。区分大小写。 更多... | |
| const CFX_ByteString & | operator= (FX_LPCSTR str) |
| 赋值(=)运算符重载。来自字符字符串。 更多... | |
| const CFX_ByteString & | operator= (FX_BSTR bstrc) |
| 赋值(=)运算符重载。来自常量字节字符串。 更多... | |
| const CFX_ByteString & | operator= (const CFX_ByteString &stringSrc) |
| 赋值(=)运算符重载。来自CFX_ByteString对象。 更多... | |
| const CFX_ByteString & | operator= (const CFX_BinaryBuf &buf) |
| 赋值(=)运算符重载。来自CFX_BinaryBuf对象。 更多... | |
| bool | operator== (FX_LPCSTR str) const |
| 比较(==)运算符重载。区分大小写。 更多... | |
| bool | operator== (FX_BSTR str) const |
| 比较(==)运算符重载。区分大小写。 更多... | |
| bool | operator== (const CFX_ByteString &str) const |
| 比较(==)运算符重载。区分大小写。 更多... | |
| FX_BYTE | operator[] (FX_STRSIZE nIndex) const |
| 下标([])运算符重载。它检索由nIndex中基于零的索引指定的单个字节。 更多... | |
| void | ReleaseBuffer (FX_STRSIZE len=-1) |
| 释放由函数CFX_ByteString::GetBuffer或 CFX_ByteString::LockBuffer获取的缓冲区,并设置修改后字符串的长度。 更多... | |
| FX_STRSIZE | Remove (FX_CHAR ch) |
| 删除特定字符的所有出现。 更多... | |
| FX_STRSIZE | Replace (FX_BSTR lpszOld, FX_BSTR lpszNew) |
| 将字符串中的所有模式替换为新的子字符串。 更多... | |
| void | Reserve (FX_STRSIZE len) |
| 保留可以容纳指定字节数的缓冲区。 更多... | |
| FX_STRSIZE | ReverseFind (FX_CHAR ch) const |
| 从字符串末尾查找字符 更多... | |
| CFX_ByteString | Right (FX_STRSIZE count) const |
| 从此CFX_ByteString对象中提取最后(最右边)count个字节作为子字符串。 更多... | |
| void | SetAt (FX_STRSIZE nIndex, FX_CHAR ch) |
| 覆盖由索引号指定的单个字节。 更多... | |
| void | TrimLeft () |
| 从字节字符串的左侧修剪空白字符。 更多... | |
| void | TrimLeft (FX_CHAR chTarget) |
| 从字节字符串左侧修剪指定字符的连续出现。 更多... | |
| void | TrimLeft (FX_BSTR lpszTargets) |
| 从字节字符串左侧修剪指定字符的连续出现。 更多... | |
| void | TrimRight () |
| 从字节字符串的右侧修剪空白字符。 更多... | |
| void | TrimRight (FX_CHAR chTarget) |
| 从字节字符串右侧修剪指定字符的连续出现。 更多... | |
| void | TrimRight (FX_BSTR lpszTargets) |
| 从字节字符串右侧修剪指定字符的连续出现。 更多... | |
| CFX_WideString | UTF8Decode () const |
| 解码UTF-8 unicode字符串(假设此字节字符串是UTF-8编码的)。 更多... | |
静态 Public 成员函数 | |
| static CFX_ByteString | FormatFloat (FX_FLOAT f, int precision=0) |
| 从浮点数转换。 更多... | |
| static CFX_ByteString | FormatInteger (FX_INT32 i, FX_DWORD flags=0) |
| 从整数转换。 更多... | |
| static CFX_ByteString | FormatInteger64 (FX_INT64 i) |
| 从Integer64转换。 更多... | |
| static CFX_ByteString | FromUnicode (FX_LPCWSTR ptr, FX_STRSIZE len=-1) |
| 从Unicode字符串创建CFX_ByteString对象。从Unicode转换为系统多字节字符集。 更多... | |
| static CFX_ByteString | FromUnicode (const CFX_WideString &str) |
| 从CFX_WideString对象创建CFX_ByteString对象。 更多... | |
| static CFX_ByteString | LoadFromFile (FX_BSTR file_path) |
| 加载文件的全部内容。 更多... | |
字节字符串类
| CFX_ByteString::CFX_ByteString | ( | const CFX_ByteString & | str | ) |
复制构造函数。
| [in] | str | CFX_ByteString对象的常量引用。 |
|
explicit |
从单个字符构造。
| [in] | ch | 单个字符。 |
| CFX_ByteString::CFX_ByteString | ( | FX_LPCSTR | ptr, |
| FX_STRSIZE | len = -1 |
||
| ) |
从字符字符串构造。
| [in] | ptr | 指向常量字符字符串的指针。 |
| [in] | len | 字符字符串的长度。len对于以零结尾的字符串可以为-1。 |
| CFX_ByteString::CFX_ByteString | ( | FX_LPCBYTE | ptr, |
| FX_STRSIZE | len | ||
| ) |
从字节字符串构造。
| [in] | ptr | 指向常量字节字符串的指针。 |
| [in] | len | 字节字符串的长度。 |
| CFX_ByteString::CFX_ByteString | ( | FX_BSTR | bstrc | ) |
从CFX_ByteStringC对象的常量引用构造。
| [in] | bstrc | CFX_ByteStringC对象的常量引用。 |
连接构造函数。
| [in] | bstrc1 | 第一个CFX_ByteStringC对象的常量引用。 |
| [in] | bstrc2 | 第二个CFX_ByteStringC对象的常量引用。 |
| CFX_ByteString::~CFX_ByteString | ( | ) |
析构函数。
| int CFX_ByteString::Compare | ( | FX_BSTR | str | ) | const |
将字符串与另一个字符串进行比较。区分大小写。
| [in] | str | 要比较的字节字符串。 |
| void CFX_ByteString::ConvertFrom | ( | const CFX_WideString & | str, |
| CFX_CharMap * | pCharMap = NULL |
||
| ) |
使用指定的字符映射器将unicode数据加载到此字节字符串中。 如果未指定字符映射器,将使用系统默认映射器。
| [in] | str | 输入的unicode字符串。 |
| [in] | pCharMap | 指定用于转换的字符映射器。 |
| FX_STRSIZE CFX_ByteString::Delete | ( | FX_STRSIZE | index, |
| FX_STRSIZE | count = 1 |
||
| ) |
从指定位置开始删除一个或多个字符。
| [in] | index | 指定字节字符串中开始删除的基于零的索引。 |
| [in] | count | 要删除的字节数。 |
| void CFX_ByteString::Empty | ( | ) |
将此字符串设置为空。
| bool CFX_ByteString::Equal | ( | FX_BSTR | str | ) | const |
检查当前字符串是否等于另一个字符串。区分大小写。
如果只需要检查两个字符串是否相等,此函数比函数CFX_ByteString::Compare更快。
| [in] | str | 要比较的字节字符串。 |
| bool CFX_ByteString::EqualNoCase | ( | FX_BSTR | str | ) | const |
检查当前字符串是否等于另一个字符串,不考虑大小写。
此函数将字母'A'-'Z'与'a'-'z'视为相同。
| [in] | str | 要比较的字节字符串。 |
| FX_STRSIZE CFX_ByteString::Find | ( | FX_BSTR | lpszSub, |
| FX_STRSIZE | start = 0 |
||
| ) | const |
从指定位置查找子字符串。仅找到第一次出现的位置。
| [in] | lpszSub | 要查找的子字符串。 |
| [in] | start | 指定进行查找的起始位置的基于零的索引。 |
| 找到第一次出现的位置。-1表示未找到。 |
| FX_STRSIZE CFX_ByteString::Find | ( | FX_CHAR | ch, |
| FX_STRSIZE | start = 0 |
||
| ) | const |
从指定位置查找字符。仅找到第一次出现的位置。
| [in] | ch | 要查找的字符。 |
| [in] | start | 指定进行查找的起始位置的基于零的索引。 |
| 找到第一次出现的位置。-1表示未找到。 |
| void CFX_ByteString::Format | ( | FX_LPCSTR | lpszFormat, |
| ... | |||
| ) |
将一些参数格式化到此字节字符串中。
在桌面平台上,此函数支持所有sprintf()格式。
在嵌入式平台上,它仅支持格式的子集:
| [in] | lpszFormat | 指定格式控制字符串。 |
|
static |
从浮点数转换。
| [in] | f | 输入的浮点数。 |
| [in] | precision | 小数位数。默认值:0。 |
|
static |
从整数转换。
标志可以是以下标志(单个或复合):
| [in] | i | 输入的32位整数。 |
| [in] | flags | 格式化标志。默认值:0。 |
|
static |
从Integer64转换。
| [in] | i | 输入的64位整数。 |
| void CFX_ByteString::FormatV | ( | FX_LPCSTR | lpszFormat, |
| va_list | argList | ||
| ) |
使用va_list将一些参数格式化到此字节字符串中。
| [in] | lpszFormat | 指定格式控制字符串。 |
| [in] | argList | 可变参数列表。 |
|
static |
从Unicode字符串创建CFX_ByteString对象。从Unicode转换为系统多字节字符集。
| [in] | ptr | 指向常量Unicode字符串的指针。 |
| [in] | len | Unicode字符串的长度。len对于以零结尾的Unicode字符串可以为-1。 |
|
static |
从CFX_WideString对象创建CFX_ByteString对象。
| [in] | str | 常量CFX_WideString对象的引用。 |
|
inline |
获取由索引号指定的单个字节。
| [in] | nIndex | 指定字节字符串中基于零的索引。 |
| FX_LPSTR CFX_ByteString::GetBuffer | ( | FX_STRSIZE | len | ) |
获取分配了指定字节数的缓冲区。
此字符串的内容不会被函数CFX_ByteString::GetBuffer影响。 调用者可以修改返回的缓冲区,并应在修改完成后调用函数CFX_ByteString::ReleaseBuffer。
| [in] | len | 期望获取的长度。 |
| FX_DWORD CFX_ByteString::GetID | ( | FX_STRSIZE | start_pos = 0 | ) | const |
|
inline |
获取字节字符串中的字节数(不计算任何可能的终止符)。
| FX_STRSIZE CFX_ByteString::Insert | ( | FX_STRSIZE | index, |
| FX_CHAR | ch | ||
| ) |
在指定位置之前插入字符。
| [in] | index | 指定字节字符串中基于零的索引。 |
| [in] | ch | 单个字符。 |
|
inline |
检查当前字符串对象是否为空。
| CFX_ByteString CFX_ByteString::Left | ( | FX_STRSIZE | count | ) | const |
从此CFX_ByteString对象中提取第一个(最左边)count个字节作为子字符串。
| [in] | count | 期望为子字符串提取的字节数。 |
| void CFX_ByteString::Load | ( | FX_LPCBYTE | str, |
| FX_STRSIZE | len | ||
| ) |
从字节字符串加载。
| [in] | str | 指向常量字节字符串的指针。 |
| [in] | len | 字节字符串的长度。 |
|
static |
加载文件的全部内容。
| [in] | file_path | 文件路径。 |
| FX_LPSTR CFX_ByteString::LockBuffer | ( | ) |
锁定并获取当前字符串缓冲区,以便调用者可以修改返回的缓冲区。
调用者可以修改返回的缓冲区,并应在修改完成后调用函数CFX_ByteString::ReleaseBuffer。
| void CFX_ByteString::MakeLower | ( | ) |
将英文字母的大小写更改为小写。
| void CFX_ByteString::MakeUpper | ( | ) |
将英文字母的大小写更改为大写。
| CFX_ByteString CFX_ByteString::Mid | ( | FX_STRSIZE | first | ) | const |
从此CFX_ByteString对象中提取子字符串,从位置nFirst(基于零)开始到最后。
| [in] | first | 指定此CFX_ByteString对象中起始位置的基于零的索引。 |
| CFX_ByteString CFX_ByteString::Mid | ( | FX_STRSIZE | first, |
| FX_STRSIZE | count | ||
| ) | const |
从此CFX_ByteString对象中提取count个字节的子字符串,从位置nFirst(基于零)开始到最后。
| [in] | first | 指定此CFX_ByteString对象中起始位置的基于零的索引。 |
| [in] | count | 期望为子字符串提取的字节数。 |
|
inline |
比较(!=)运算符重载。区分大小写。
| [in] | str | 要比较的以null结尾的字符字符串。 |
|
inline |
比较(!=)运算符重载。区分大小写。
| [in] | str | 要比较的以null结尾的常量字节字符串。 |
|
inline |
比较(!=)运算符重载。区分大小写。
| [in] | str | 要比较的以null结尾的字节字符串。 |
| const CFX_ByteString& CFX_ByteString::operator+= | ( | FX_CHAR | ch | ) |
连接(+=)运算符重载。连接单个字符。
| [in] | ch | 单个字符。 |
| const CFX_ByteString& CFX_ByteString::operator+= | ( | FX_LPCSTR | str | ) |
连接(+=)运算符重载。连接以空字符结尾的字符串。
| [in] | str | 指向常量以空字符结尾的字符串的指针。 |
| const CFX_ByteString& CFX_ByteString::operator+= | ( | const CFX_ByteString & | str | ) |
连接(+=)运算符重载。连接CFX_ByteString对象。
| [in] | str | 常量CFX_ByteString对象的引用。 |
| const CFX_ByteString& CFX_ByteString::operator+= | ( | FX_BSTR | bstrc | ) |
连接(+=)运算符重载。连接常量CFX_ByteStringC对象。
| [in] | bstrc | 常量CFX_ByteStringC对象的引用。 |
| bool CFX_ByteString::operator< | ( | const CFX_ByteString & | rhs | ) | const |
比较(<)运算符重载。区分大小写。
| [in] | rhs | 右侧字符串。 |
| const CFX_ByteString& CFX_ByteString::operator= | ( | FX_LPCSTR | str | ) |
赋值(=)运算符重载。来自字符字符串。
| [in] | str | 指向常量字符字符串的指针。 |
| const CFX_ByteString& CFX_ByteString::operator= | ( | FX_BSTR | bstrc | ) |
赋值(=)运算符重载。来自常量字节字符串。
| [in] | bstrc | 常量字节字符串的引用。 |
| const CFX_ByteString& CFX_ByteString::operator= | ( | const CFX_ByteString & | stringSrc | ) |
赋值(=)运算符重载。来自CFX_ByteString对象。
| [in] | stringSrc | 常量CFX_ByteString对象的引用。 |
| const CFX_ByteString& CFX_ByteString::operator= | ( | const CFX_BinaryBuf & | buf | ) |
赋值(=)运算符重载。来自CFX_BinaryBuf对象。
| [in] | buf | 常量CFX_BinaryBuf对象的引用。 |
|
inline |
比较(==)运算符重载。区分大小写。
| [in] | str | 要比较的以null结尾的字符字符串。 |
|
inline |
比较(==)运算符重载。区分大小写。
| [in] | str | 要比较的以null结尾的常量字节字符串。 |
| bool CFX_ByteString::operator== | ( | const CFX_ByteString & | str | ) | const |
比较(==)运算符重载。区分大小写。
| [in] | str | 要比较的以null结尾的字节字符串。 |
|
inline |
下标([])运算符重载。它检索由nIndex中基于零的索引指定的单个字节。
| [in] | nIndex | 指定字节字符串中基于零的索引。 |
| void CFX_ByteString::ReleaseBuffer | ( | FX_STRSIZE | len = -1 | ) |
释放由函数CFX_ByteString::GetBuffer或 CFX_ByteString::LockBuffer获取的缓冲区,并设置修改后字符串的长度。
如果参数len为-1,则假定它是以零结尾的字符串。
| [in] | len | 期望释放到的长度。默认值:-1。 |
| FX_STRSIZE CFX_ByteString::Remove | ( | FX_CHAR | ch | ) |
删除特定字符的所有出现。
| [in] | ch | 指定要删除的字符。 |
| FX_STRSIZE CFX_ByteString::Replace | ( | FX_BSTR | lpszOld, |
| FX_BSTR | lpszNew | ||
| ) |
将字符串中的所有模式替换为新的子字符串。
| [in] | lpszOld | 指定要在字节字符串中匹配和替换的字符串。 |
| [in] | lpszNew | 指定要替换的字符串。 |
| void CFX_ByteString::Reserve | ( | FX_STRSIZE | len | ) |
保留可以容纳指定字节数的缓冲区。
此字符串的内容不会改变。这可以在应用程序预期 字符串可能增长多次时使用,在这种情况下,保留更大的缓冲区将支持字符串增长 而无需缓冲区重新分配。
| [in] | len | 期望保留的长度。 |
| FX_STRSIZE CFX_ByteString::ReverseFind | ( | FX_CHAR | ch | ) | const |
从字符串末尾查找字符
| [in] | ch | 要在当前字符串中从末尾查找的字符。 |
| CFX_ByteString CFX_ByteString::Right | ( | FX_STRSIZE | count | ) | const |
从此CFX_ByteString对象中提取最后(最右边)count个字节作为子字符串。
| [in] | count | 期望为子字符串提取的字节数。 |
| void CFX_ByteString::SetAt | ( | FX_STRSIZE | nIndex, |
| FX_CHAR | ch | ||
| ) |
覆盖由索引号指定的单个字节。
| [in] | nIndex | 指定字节字符串中基于零的索引。 |
| [in] | ch | 单个字符。 |
| void CFX_ByteString::TrimLeft | ( | ) |
从字节字符串的左侧修剪空白字符。
| void CFX_ByteString::TrimLeft | ( | FX_CHAR | chTarget | ) |
从字节字符串左侧修剪指定字符的连续出现。
| [in] | chTarget | 指定的字符。 |
| void CFX_ByteString::TrimLeft | ( | FX_BSTR | lpszTargets | ) |
从字节字符串左侧修剪指定字符的连续出现。
| [in] | lpszTargets | 指定的字符。 |
| void CFX_ByteString::TrimRight | ( | ) |
从字节字符串的右侧修剪空白字符。
| void CFX_ByteString::TrimRight | ( | FX_CHAR | chTarget | ) |
从字节字符串右侧修剪指定字符的连续出现。
| [in] | chTarget | 指定的字符。 |
| void CFX_ByteString::TrimRight | ( | FX_BSTR | lpszTargets | ) |
从字节字符串右侧修剪指定字符的连续出现。
| [in] | lpszTargets | 指定的字符。 |
| CFX_WideString CFX_ByteString::UTF8Decode | ( | ) | const |
解码UTF-8 unicode字符串(假设此字节字符串是UTF-8编码的)。