CMGDK r49-rc2
公有成员 | 公有属性 | 保护成员 | 保护属性
hgl::WideString类参考

宽字符串处理类 更多...

#include <WideString.H>

所有成员的列表。

公有成员

 WideString ()
 WideString (const char)
 WideString (const char *)
 WideString (const wchar_t)
 WideString (const wchar_t *)
 WideString (const char *, int)
 WideString (const wchar_t *, int)
 WideString (CCP, const char *, int=-1)
 WideString (const WideString &)
 WideString (const PropertyString &)
 WideString (int)
 WideString (uint)
 WideString (int64)
 WideString (uint64)
 WideString (double)
 ~WideString ()
void SetString (const wchar_t *, int=-1, bool=false)
 设置字符串
void EquString (const wchar_t *str, int len)
 设置字符串，并明确长度和可私有性
void Unlink ()
 和其它同内容的WideString断开连接
wchar_t * w_str () const
 返回一个wchar_t *类型的字符串指针(同wc_str())
wchar_t * wc_str () const
 返回一个wchar_t *类型的字符串指针(同w_str())
wchar_t * wc_copy () const
 返回一个wchar_t *类型的字符串指针，需要自己delete[]掉
wchar_t * wc_offset (int off) const
 返回一个wchar_t *类型的字符串指针
void Clear ()
 清除字符串的数据
void ConvertString (CCP, const char *, int=-1)
 转换一个指定代码的char *字符串到本类中
void Strcpy (const char *)
 复制一个字符串到本类中来(char *)
void Strcpy (CCP ccp, const char *as)
 复制一个字符串到本类中来(char *)
void Strcpy (const wchar_t *)
 复制一个字符串到本类中来(wchar_t *)
void Strcpy (const WideString &str)
 复制一个字符串到本类中来
void Strcpy (const char *, int)
 复制一个字符串到本类中来(char *)
void Strcpy (const wchar_t *, int)
 复制一个字符串到本类中来(wchar_t *)
void Strcpy (const WideString &str, int len)
 复制一个字符串到本类中来
void Strcpy (const WideString &str, int start, int len)
void Strcat (const wchar_t)
 连接一个字符到本类字符串的后面
void Strcat (const char *)
 连接一个字符串到本类字符串的后面(char *)
void Strcat (const wchar_t *)
 连接一个字符串到本类字符串的后面(wchar_t *)
void Strcat (const WideString &str)
 连接一个字符串到本类字符串的后面
void Strcat (const char *, int)
 连接一个字符串到本类字符串的后面(char *)
void Strcat (const wchar_t *, int)
 连接一个字符串到本类字符串的后面(wchar_t *)
void Strcat (const WideString &str, int len)
 连接一个字符串到本类字符串的后面
void Strcat (const WideString &str, int start, int len)
void Sprintf (const char *,...)
 对本类进行格式化赋值(char *)
void CatSprintf (const char *,...)
 产生一个格式化字符串并添加到本类的字符串后面(char *)
void Sprintf (CCP, const char *,...)
 对本类进行格式化赋值(char *)
void CatSprintf (CCP, const char *,...)
 产生一个格式化字符串并添加到本类的字符串后面(char *)
void Sprintf (const wchar_t *,...)
 对本类进行格式化赋值(wchar_t *)
void CatSprintf (const wchar_t *,...)
 产生一个格式化字符串并添加到本类的字符串后面(wchar_t *)
int Strcmp (const wchar_t *) const
 与另一个字符串比较
int Strcmp (const WideString &) const
 与另一个字符串比较
int Strcmp (const wchar_t *, int) const
 与另一个字符串比较
int Strcmp (const WideString &, int) const
 与另一个字符串比较
int ToAnsi (char *str=0, int=0, CCP ccp=ccpGBK) const
 将当前字符串转换成ANSI格式
int ToAnsi (char **, CCP ccp=ccpGBK) const
 将当前字符串转换成ANSI格式
int ToUTF8 (char **) const
 将当前字符串转换成UTF8格式
bool ToBool () const
 将本类中的字符串转换成布尔数值并返回
int ToInt () const
 将本类中的字符串转换成整型数值并返回
uint ToUInt () const
 将本类中的字符串转换成整型数值并返回
double ToFloat () const
 将本类中的字符串转换成浮点数值并返回
void LowerCase ()
 将本类中的字母全部转为小写
void UpperCase ()
 将本类中的字母全部转为大写
void Insert (int, const wchar_t)
 在指定位置插入一个字符
void Insert (int, const wchar_t *)
 在指定位置插入一个字符串
void Insert (int, const WideString &)
 在指定位置插入一个字符串
void Delete (int, int)
 删除指定位置的指定个字符
void Write (int, const wchar_t *, int len=-1)
 在指定位置写入一个字符串
void Write (int, const WideString &)
 在指定位置写入一个字符串
void Trim ()
 删除字符串前后的空格
void TrimLeft ()
 删除字符串前面的空格
void TrimRight ()
 删除字符串后面的空格
void TrimLeft (int n)
 删除字符串前面的若干字符
void TrimRight (int n)
 删除字符串后面的若干字符
void Clip (int, int)
 截取从指定位置开始的指定个字符
void ClipLeft (int)
 从前方截取指定个字符
void ClipRight (int)
 从结尾截取指定个字符
wchar_t GetChar (int) const
void SetChar (int, wchar_t)
void FillChar (wchar_t)
 填充字符串
wchar_t operator[] (int n) const
int StatChar (wchar_t) const
 统计字符串中某个字符的个数
int StatLine () const
 统计行数
int FindChar (wchar_t) const
 返回当前字符串中指定字符开始的索引(从左至右)
int FindChar (int, wchar_t) const
 返回当前字符串中指定字符开始的索引(从左至右)
int FindRightChar (wchar_t) const
 返回当前字符串中指定字符开始的索引(从右至左)
int FindString (const WideString &) const
 返回当前字符串中指定子串开始的索引
wchar_t * StrChr (wchar_t ch) const
 返回当前字符串中指定字符所在的位置(从左至右)
wchar_t * StrRChr (wchar_t ch) const
 返回当前字符串中指定字符所在的位置(从右至左)
bool ClearSubString (const WideString &)
 清除当前字符串中指定子串
void ReplaceChar (wchar_t, wchar_t)
 替换字符

公有属性

Property< const int > Length
 字符串长度虚拟变量

保护成员

wchar_t * GetString () const
const int GetLength () const
void ClearString ()
void CopyString (const WideString &)

保护属性

PrivateString * data

详细描述

宽字符串处理类

C/C++ wchar_t 字符串处理类

构造及析构函数文档

hgl::WideString::WideString ( )

本类构造函数

hgl::WideString::WideString ( const char  ch)

本类构造函数，将字符串设置成某一个字符

参数:
ch字符
hgl::WideString::WideString ( const char *  str)

本类构造函数,可复制一个C风格的字符串到本类中,存放后将自动转换为UNICODE标准。(默认传入的字符是GB18030标准)

参数:
str赋值进来的C风格字符串
hgl::WideString::WideString ( const wchar_t  ch)

本类构造函数，将字符串设置成某一个字符

参数:
ch字符
hgl::WideString::WideString ( const wchar_t *  str)

本类构造函数,可复制一个C风格的字符串到本类中

参数:
str赋值进来的C风格字符串
hgl::WideString::WideString ( const char *  str,
int  len 
)

本类构造函数,可复制一个C风格的字符串到本类中

参数:
str赋值进来的C风格字符串
len字符串长度
hgl::WideString::WideString ( const wchar_t *  str,
int  len 
)

本类构造函数,可复制一个C风格的字符串到本类中

参数:
str赋值进来的C风格字符串
len字符串长度
hgl::WideString::WideString ( CCP  code,
const char *  str,
int  len = -1 
)

本类构造函数,将一个系统支持的代码页字符串存入本类,存放后都将被转换为UNICODE标准

参数:
code代码页
str字符串
len长度(-1表示全部)
hgl::WideString::WideString ( const WideString &  str)

本类构造函数,从另一个WideString类中复制整个字符串过来

参数:
str源字符串类
hgl::WideString::WideString ( const PropertyString &  ps)
hgl::WideString::WideString ( int  n)

本类构造函数,并将一个数字转换成字符串形式

参数:
n数值
hgl::WideString::WideString ( uint  n)

本类构造函数,并将一个数字转换成字符串形式

参数:
n数值
hgl::WideString::WideString ( int64  n)

本类构造函数,并将一个数字转换成字符串形式

参数:
n数值
hgl::WideString::WideString ( uint64  n)

本类构造函数,并将一个数字转换成字符串形式

参数:
n数值
hgl::WideString::WideString ( double  n)

本类构造函数,并将一个双精度浮点数转换成字符串

参数:
n数值
hgl::WideString::~WideString ( )

本类析构函数

成员函数文档

void hgl::WideString::CatSprintf ( const char *  fmt,
  ... 
)

产生一个格式化字符串并添加到本类的字符串后面(char *)

使用sprintf格式化方式制作成的字串添加到本类字串的后面(ANSI)

参数:
fmt格式化字串
void hgl::WideString::CatSprintf ( CCP  ccp,
const char *  fmt,
  ... 
)

产生一个格式化字符串并添加到本类的字符串后面(char *)

使用sprintf格式化方式制作成的字串添加到本类字串的后面(ANSI)

参数:
fmt格式化字串
void hgl::WideString::CatSprintf ( const wchar_t *  fmt,
  ... 
)

产生一个格式化字符串并添加到本类的字符串后面(wchar_t *)

使用sprintf格式化方式制作成的字串添加到本类字串的后面(UNICODE)

参数:
fmt格式化字串
void hgl::WideString::Clear ( ) [inline]

清除字符串的数据

void hgl::WideString::ClearString ( ) [protected]
bool hgl::WideString::ClearSubString ( const WideString &  ss)

清除当前字符串中指定子串

清除前当字符串中的指定子串

参数:
ss子字符串
返回:
是否有子串出现过
void hgl::WideString::Clip ( int  start,
int  count 
)

截取从指定位置开始的指定个字符

从指定位置开始截取指定数量的字符

参数:
start开始位置
count字符数量
void hgl::WideString::ClipLeft ( int  count)

从前方截取指定个字符

void hgl::WideString::ClipRight ( int  count)

从结尾截取指定个字符

void hgl::WideString::ConvertString ( CCP  code,
const char *  str,
int  len = -1 
)

转换一个指定代码的char *字符串到本类中

将一个其它代码页的字符串转换成UNICODE标准的字符串并存在本类中

参数:
code代码页
str字符串
len字符串长度，-1表示自动
void hgl::WideString::CopyString ( const WideString &  str) [protected]
void hgl::WideString::Delete ( int  pos,
int  n 
)

删除指定位置的指定个字符

删除指定位置的指定个字符

参数:
pos要删除的位置
n要删除的字符个数
void hgl::WideString::EquString ( const wchar_t *  str,
int  len 
) [inline]

设置字符串，并明确长度和可私有性

void hgl::WideString::FillChar ( wchar_t  ch)

填充字符串

int hgl::WideString::FindChar ( wchar_t  ch) const

返回当前字符串中指定字符开始的索引(从左至右)

该方法返回本字符串中指定字符第一次出现的位置

参数:
ch要查找的字符
返回:
-1 未找到
int hgl::WideString::FindChar ( int  start,
wchar_t  ch 
) const

返回当前字符串中指定字符开始的索引(从左至右)

该方法返回本字符串中指定字符第一次出现的位置

参数:
start开始查找的字符偏移
ch要查找的字符
返回:
-1 未找到
int hgl::WideString::FindRightChar ( wchar_t  ch) const

返回当前字符串中指定字符开始的索引(从右至左)

该方法返回本字符串中指定字符最后一次出现的位置

返回:
-1 未找到
int hgl::WideString::FindString ( const WideString &  subStr) const

返回当前字符串中指定子串开始的索引

该方法返回本字符串中子串subStr开始的索引

参数:
subStr要查找的子串
返回:
子串开始的索引,<0表示失败
wchar_t hgl::WideString::GetChar ( int  n) const

取得字符串中某位置处的字符

参数:
n位置
返回:
字符,出错返回0
const int hgl::WideString::GetLength ( ) const [inline, protected]
wchar_t* hgl::WideString::GetString ( ) const [inline, protected]
void hgl::WideString::Insert ( int  pos,
const wchar_t  ch 
)

在指定位置插入一个字符

在指定位置插入一个字符

参数:
pos要插入的位置
ch要插入的字符
void hgl::WideString::Insert ( int  pos,
const wchar_t *  str 
)

在指定位置插入一个字符串

在指定位置插入一个字符串

参数:
pos要插入的位置
str要插入的字符串
void hgl::WideString::Insert ( int  pos,
const WideString &  str 
)

在指定位置插入一个字符串

在指定位置插入一个字符串

参数:
pos要插入的位置
str要插入的字符串
void hgl::WideString::LowerCase ( )

将本类中的字母全部转为小写

将本字符串中的英文字符全部转换成小写

wchar_t hgl::WideString::operator[] ( int  n) const [inline]
void hgl::WideString::ReplaceChar ( wchar_t  new_char,
wchar_t  old_char 
)

替换字符

void hgl::WideString::SetChar ( int  n,
wchar_t  ch 
)

更改某个位置处的字符

参数:
n位置
ch新的字符
void hgl::WideString::SetString ( const wchar_t *  str,
int  len = -1,
bool  _private = false 
)

设置字符串

设置字符串

参数:
str字符串内容
len字符串长度,为-1表示自动测试长度
_private是否可私有，如为true，则由WideString来释放
void hgl::WideString::Sprintf ( CCP  ccp,
const char *  fmt,
  ... 
)

对本类进行格式化赋值(char *)

使用sprintf格式化方式给本类赋值一个字串(ANSI)

参数:
fmt格式化字串
void hgl::WideString::Sprintf ( const wchar_t *  fmt,
  ... 
)

对本类进行格式化赋值(wchar_t *)

使用sprintf格式化方式给本类赋值一个字串(UNICODE)

参数:
fmt格式化字串
void hgl::WideString::Sprintf ( const char *  fmt,
  ... 
)

对本类进行格式化赋值(char *)

使用sprintf格式化方式给本类赋值一个字串(ANSI)

参数:
fmt格式化字串
int hgl::WideString::StatChar ( wchar_t  ch) const

统计字符串中某个字符的个数

统计某个字符在这个字符串中出现过多少次

参数:
ch字符
返回:
该字符的出现次数
int hgl::WideString::StatLine ( ) const

统计行数

统计这个字符串有多少行

返回:
行数
void hgl::WideString::Strcat ( const wchar_t  ch)

连接一个字符到本类字符串的后面

将一个C风格的字符添加到本类字符串的后面

参数:
strC风格的字符
void hgl::WideString::Strcat ( const char *  ansi_str)

连接一个字符串到本类字符串的后面(char *)

将一个C风格的字符串添加到本类字符串的后面

参数:
ansi_strC风格的字符串
void hgl::WideString::Strcat ( const wchar_t *  str)

连接一个字符串到本类字符串的后面(wchar_t *)

将一个C风格的字符串添加到本类字符串的后面

参数:
strC风格的字符串
void hgl::WideString::Strcat ( const WideString &  str) [inline]

连接一个字符串到本类字符串的后面

void hgl::WideString::Strcat ( const char *  ansi_str,
int  len 
)

连接一个字符串到本类字符串的后面(char *)

将一个C风格的字符串添加到本类字符串的后面

参数:
ansi_strC风格的字符串
len长度
void hgl::WideString::Strcat ( const wchar_t *  str,
int  len 
)

连接一个字符串到本类字符串的后面(wchar_t *)

将一个C风格的字符串添加到本类字符串的后面

参数:
strC风格的字符串
len长度
void hgl::WideString::Strcat ( const WideString &  str,
int  start,
int  len 
) [inline]
参数:
len连接一个字符串到本类字符串的后面
void hgl::WideString::Strcat ( const WideString &  str,
int  len 
) [inline]

连接一个字符串到本类字符串的后面

wchar_t * hgl::WideString::StrChr ( wchar_t  ch) const

返回当前字符串中指定字符所在的位置(从左至右)

该方法返回本字符串中指定字符第一次出现的位置

参数:
ch要查找的字符
返回:
NULL 未找到
位置指针
int hgl::WideString::Strcmp ( const WideString &  str) const

与另一个字符串比较

比较当前字符串与指定字符串间的大小

参数:
str要与当前字符串比较的字符串
返回:
=0 双方一样
<0 对方大
>0 当前字符串大
int hgl::WideString::Strcmp ( const wchar_t *  str) const

与另一个字符串比较

比较当前字符串与指定字符串间的大小

参数:
str要与当前字符串比较的字符串
返回:
=0 双方一样
<0 对方大
>0 当前字符串大
int hgl::WideString::Strcmp ( const wchar_t *  str,
int  size 
) const

与另一个字符串比较

比较当前字符串与指定字符串间的大小

参数:
str要与当前字符串比较的字符串
size要比较的字符最大长度
返回:
=0 双方一样
<0 对方大
>0 当前字符串大
int hgl::WideString::Strcmp ( const WideString &  str,
int  size 
) const

与另一个字符串比较

比较当前字符串与指定字符串间的大小

参数:
str要与当前字符串比较的字符串
size要比较的字符最大长度
返回:
=0 双方一样
<0 对方大
>0 当前字符串大
void hgl::WideString::Strcpy ( CCP  ccp,
const char *  as 
) [inline]

复制一个字符串到本类中来(char *)

void hgl::WideString::Strcpy ( const char *  str,
int  len 
)

复制一个字符串到本类中来(char *)

将一个C风格的字符串赋给本类

参数:
strC风格的字符串
len长度
void hgl::WideString::Strcpy ( const wchar_t *  str,
int  len 
)

复制一个字符串到本类中来(wchar_t *)

将一个C风格的字符串赋给本类

参数:
strC风格的字符串
len长度
void hgl::WideString::Strcpy ( const WideString &  str,
int  len 
) [inline]

复制一个字符串到本类中来

void hgl::WideString::Strcpy ( const WideString &  str,
int  start,
int  len 
) [inline]
参数:
len复制一个字符串到本类中来
void hgl::WideString::Strcpy ( const wchar_t *  str)

复制一个字符串到本类中来(wchar_t *)

将一个C风格的字符串赋给本类

参数:
strC风格的字符串
void hgl::WideString::Strcpy ( const WideString &  str) [inline]

复制一个字符串到本类中来

void hgl::WideString::Strcpy ( const char *  str)

复制一个字符串到本类中来(char *)

将一个C风格的字符串赋给本类

参数:
strC风格的字符串
wchar_t * hgl::WideString::StrRChr ( wchar_t  ch) const

返回当前字符串中指定字符所在的位置(从右至左)

该方法返回本字符串中指定字符最后一次出现的位置

参数:
ch要查找的字符
返回:
NULL 未找到
位置指针
int hgl::WideString::ToAnsi ( char *  str = 0,
int  max = 0,
CCP  ccp = ccpGBK 
) const

将当前字符串转换成ANSI格式

将当前字符串转换成ANSI编码。如果str为NULL或者max为0。则不转换，但仍然返回转换成ANSI编码后的字符串的长度

参数:
strANSI编码字符串存放缓冲区的指针,可以为NULL
max缓冲区的大小,可以为0
ccp代码页,默认GBK
返回:
转换成ANSI后编码后的字符串长度
int hgl::WideString::ToAnsi ( char **  str,
CCP  ccp = ccpGBK 
) const

将当前字符串转换成ANSI格式

将当前字符串转换成ANSI编码
自动分配内存并赋给指定指针，并返回ANSI字串长度,需手动delete[]

参数:
strANSI编码字符串存放缓冲区指针
ccp代码页，默认GBK
返回:
转换成ANSI后编码后的字符串长度
bool hgl::WideString::ToBool ( ) const

将本类中的字符串转换成布尔数值并返回

将本类中的字符串转换成布尔值并返回

返回:
转换后的值
double hgl::WideString::ToFloat ( ) const

将本类中的字符串转换成浮点数值并返回

将本类中的字符串转换成浮点数并返回

返回:
转换后的浮点数
int hgl::WideString::ToInt ( ) const

将本类中的字符串转换成整型数值并返回

将本类中的字符串转换成数值并返回

返回:
转换后的数值
uint hgl::WideString::ToUInt ( ) const

将本类中的字符串转换成整型数值并返回

将本类中的字符串转换成数值并返回

返回:
转换后的数值
int hgl::WideString::ToUTF8 ( char **  str) const

将当前字符串转换成UTF8格式

将当前字符串转换成UTF8编码
自动分配内存并赋给指定指针，并返回utf8字串长度,需手动delete[]

参数:
strutf8编码字符串存放缓冲区指针
返回:
转换成utf8后编码后的字符串长度
void hgl::WideString::Trim ( )

删除字符串前后的空格

void hgl::WideString::TrimLeft ( int  n) [inline]

删除字符串前面的若干字符

void hgl::WideString::TrimLeft ( )

删除字符串前面的空格

void hgl::WideString::TrimRight ( )

删除字符串后面的空格

void hgl::WideString::TrimRight ( int  n) [inline]

删除字符串后面的若干字符

void hgl::WideString::Unlink ( )

和其它同内容的WideString断开连接

和其它同内容的WideString断开连接,创立成一个独立的WideString

void hgl::WideString::UpperCase ( )

将本类中的字母全部转为大写

将本字符串中的英文字符全部转换成大写

wchar_t* hgl::WideString::w_str ( ) const [inline]

返回一个wchar_t *类型的字符串指针(同wc_str())

此函数返回一个C风格宽字符串指针

wchar_t * hgl::WideString::wc_copy ( ) const

返回一个wchar_t *类型的字符串指针，需要自己delete[]掉

此函数返回一个C风格(UNICODE编码)的字符串指针，注意这个是复制出来的，需要自己delete[] 掉

wchar_t* hgl::WideString::wc_offset ( int  off) const [inline]

返回一个wchar_t *类型的字符串指针

wchar_t* hgl::WideString::wc_str ( ) const [inline]

返回一个wchar_t *类型的字符串指针(同w_str())

void hgl::WideString::Write ( int  pos,
const WideString &  str 
)

在指定位置写入一个字符串

在指定位置写入一个字符串

参数:
pos要写入的位置
str要写入的字符串
void hgl::WideString::Write ( int  pos,
const wchar_t *  str,
int  len = -1 
)

在指定位置写入一个字符串

在指定位置写入一个字符串

参数:
pos要写入的位置
str要写入的字符串
len字符串长度，-1为自动

成员数据文档

PrivateString* hgl::WideString::data [protected]
Property<const int> hgl::WideString::Length

字符串长度虚拟变量

该类的文档由以下文件生成：
 全部 类 名字空间 文件 函数 变量 类型定义 枚举 枚举值 友元 宏定义
Generated at 2012年五月9日 星期三 22:48:44 for CMGDK by  doxygen 1.7.4