一、源代码说明

freecplus是一个Linux系统下的C/C++开源框架,源代码请前往C语言技术网(www.freecplus.net)下载。

本文介绍的是freecplus框架的字符串操作函数和类。

函数和类的声明文件是freecplus/_freecplus.h。

函数和类的定义文件是freecplus/_freecplus.cpp。

示例程序位于freecplus/demo目录中。

编译规则文件是freecplus/demo/makefile。

二、字符串复制

1、STRCPY函数

安全的strcpy函数。

函数声明:

char *STRCPY(char* dest,const size_t destlen,const char* src);

参数说明:

dest:目标字符串,不需要初始化,在STRCPY函数中有初始化代码。

destlen:目标字符串dest占用内存的大小。

src:原字符串。

返回值:目标字符串dest的地址。

示例(demo1.cpp)

/*
 *  程序名:demo1.cpp,此程序演示freecplus框架中STRCPY函数的使用。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
*/
#include "_freecplus.h"
 
int main()
{
  char str[11];   // 字符串str的大小是11字节。
 
  STRCPY(str,sizeof(str),"freecplus");  // 待复制的内容没有超过str可以存放字符串的大小。
  printf("str=%s=\n",str);    // 出输结果是str=freecplus=
  STRCPY(str,sizeof(str),"www.freecplus.net");  // 待复制的内容超过了str可以存放字符串的大小。
  printf("str=%s=\n",str);    // 出输结果是str=www.freecp=
}

2、STRNCPY函数

安全的strncpy函数。

函数声明:

char *STRNCPY(char* dest,const size_t destlen,const char* src,size_t n);

参数说明:

dest:目标字符串,不需要初始化,在STRNCPY函数中有初始化代码。

destlen:目标字符串dest占用内存的大小。

src:原字符串。

n:待复制的字节数。

返回值:目标字符串dest的地址。

示例(demo2.cpp)

/*
 *  程序名:demo2.cpp,此程序演示freecplus框架中STRNCPY函数的使用。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
*/
#include "_freecplus.h"
 
int main()
{
  char str[11];   // 字符串str的大小是11字节。
 
  STRNCPY(str,sizeof(str),"freecplus",5);  // 待复制的内容没有超过str可以存放字符串的大小。
  printf("str=%s=\n",str);    // 出输结果是str=freec=
  STRNCPY(str,sizeof(str),"www.freecplus.net",8);  // 待复制的内容没有超过str可以存放字符串的大小。
  printf("str=%s=\n",str);    // 出输结果是str=www.free=
  STRNCPY(str,sizeof(str),"www.freecplus.net",17);  // 待复制的内容超过了str可以存放字符串的大小。
  printf("str=%s=\n",str);    // 出输结果是str=www.freecp=
}

三、字符串拼接

1、STRCAT函数

安全的strcat函数。

函数声明:

char *STRCAT(char* dest,const size_t destlen,const char* src);

参数说明:

dest:目标字符串,注意,如果dest从未使过,那么需要至少一次初始化。

destlen:目标字符串dest占用内存的大小。

src:待追加字符串。

返回值:目标字符串dest的地址。

示例(demo4.cpp)

/*
 *  程序名:demo4.cpp,此程序演示freecplus框架中STRCAT函数的使用。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
*/
#include "../_freecplus.h"
 
int main()
{
  char str[11];   // 字符串str的大小是11字节。
  STRCPY(str,sizeof(str),"www");
 
  STRCAT(str,sizeof(str),".fr");  // str原有的内容加上待追加的内容没有超过str可以存放的大小。
  printf("str=%s=\n",str);        // 出输结果是str=www.fr=
 
  STRCAT(str,sizeof(str),"eecplus.net");  // str原有的内容加上待追加的内容超过了str可以存放的大小。
  printf("str=%s=\n",str);                // 出输结果是str=www.freecp=
}

2、STRNCAT函数

安全的strncat函数。

函数声明:

char *STRNCAT(char* dest,const size_t destlen,const char* src,size_t n)

参数说明:

dest:目标字符串,注意,如果dest从未使过,那么需要至少一次初始化。

destlen:目标字符串dest占用内存的大小。

src:待追加字符串。

n:待追加的字节数。

返回值:目标字符串dest的地址。

示例(demo5.cpp)

/*
 *  程序名:demo5.cpp,此程序演示freecplus框架中STRNCAT函数的使用。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
*/
#include "../_freecplus.h"
 
int main()
{
  char str[11];   // 字符串str的大小是11字节。
 
  STRCPY(str,sizeof(str),"www");
  STRNCAT(str,sizeof(str),".free",10);  // str原有的内容加上待追加的内容没有超过str可以存放的大小。
  printf("str=%s=\n",str);              // 出输结果是str=www.free=
 
  STRCPY(str,sizeof(str),"www");
  STRNCAT(str,sizeof(str),".freecplus.net",6);  // str原有的内容加上待追加的内容没有超过str可以存放的大小。
  printf("str=%s=\n",str);                      // 出输结果是str=www.freec=
 
  STRCPY(str,sizeof(str),"www");
  STRNCAT(str,sizeof(str),".freecplus.net",10); // str原有的内容加上待追加的内容超过了str可以存放的大小。
  printf("str=%s=\n",str);                      // 出输结果是str=www.freecp=
}

四、格式化输出到字符串

1、SPRINTF函数

安全的sprintf函数,将可变参数(...)按照fmt描述的格式输出到dest字符串中。

函数声明:

int SPRINTF(char *dest,const size_t destlen,const char *fmt,...);

参数说明:

dest:输出字符串,不需要初始化,在SPRINTF函数中会对它进行初始化。

destlen:输出字符串dest占用内存的大小,如果格式化后的字符串内容的长度大于destlen-1,后面的内容将丢弃。

fmt:格式控制描述。

...:填充到格式控制描述fmt中的参数。

返回值:格式化后的内容的长度,程序员一般不关心返回值。

示例(demo7.cpp)

/*
 *  程序名:demo7.cpp,此程序演示freecplus框架中SPRINTF函数的使用。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
*/
#include "_freecplus.h"
 
int main()
{
  char str[21];   // 字符串str的大小是21字节。
 
  SPRINTF(str,sizeof(str),"name:%s,no:%d","messi",10);
  printf("str=%s=\n",str);    // 出输结果是str=name:messi,no:10=
 
  SPRINTF(str,sizeof(str),"name:%s,no:%d,job:%s","messi",10,"striker");
  printf("str=%s=\n",str);    // 出输结果是str=name:messi,no:10,job=
}

2、SNPRINTF函数

安全的snprintf函数,将可变参数(...)按照fmt描述的格式输出到dest字符串中。

函数声明:

int SNPRINTF(char *dest,const size_t destlen,size_t n,const char *fmt,...);

参数说明:

dest:输出字符串,不需要初始化,在SNPRINTF函数中会对它进行初始化。

destlen:输出字符串dest占用内存的大小,如果格式化后的字符串内容的长度大于destlen-1,后面的内容将丢弃。

n:把格式化后的字符串截取n-1存放到dest中,如果n>destlen,则取destlen-1。

fmt:格式控制描述。

...:填充到格式控制描述fmt中的参数。

返回值:格式化后的内容的长度,程序员一般不关心返回值。

示例(demo8.cpp)

/*
 *  程序名:demo8.cpp,此程序演示freecplus框架中SNPRINTF函数的使用。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
*/
#include "_freecplus.h"
 
int main()
{
  char str[26];   // 字符串str的大小是11字节。
 
  SNPRINTF(str,sizeof(str),5,"messi");
  printf("str=%s=\n",str);    // 出输结果是str=mess=
 
  SNPRINTF(str,sizeof(str),9,"name:%s,no:%d,job:%s","messi",10,"striker");
  printf("str=%s=\n",str);    // 出输结果是str=name:mes=
 
  SNPRINTF(str,sizeof(str),30,"name:%s,no:%d,job:%s","messi",10,"striker");
  printf("str=%s=\n",str);    // 出输结果是str=name:messi,no:10,job:stri=
}

五、删除字符串左、右和两边字符

删除字符串左边、右边和两边指定的字符。

函数声明:

void DeleteLChar(char *str,const char chr);  // 删除字符串左边指定的字符。
void DeleteRChar(char *str,const char chr);  // 删除字符串右边指定的字符。
void DeleteLRChar(char *str,const char chr); // 删除字符串左右两边指定的字符。

参数说明:

str:待处理的字符串。

chr:需要删除的字符。

示例(demo10.cpp)

/*
 *  程序名:demo10.cpp,此程序演示freecplus框架中删除字符串左、右、两边指定字符的使用。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
*/
#include "../_freecplus.h"
 
int main()
{
  char str[11];   // 字符串str的大小是11字节。
 
  STRCPY(str,sizeof(str),"  西施  ");
  DeleteLChar(str,' ');  // 删除str左边的空格
  printf("str=%s=\n",str);    // 出输结果是str=西施  =
 
  STRCPY(str,sizeof(str),"  西施  ");
  DeleteRChar(str,' ');  // 删除str右边的空格
  printf("str=%s=\n",str);    // 出输结果是str=  西施=
 
  STRCPY(str,sizeof(str),"  西施  ");
  DeleteLRChar(str,' ');  // 删除str两边的空格
  printf("str=%s=\n",str);    // 出输结果是str=西施=
}

注意,如果要删除字符串中间的字符,可以用freecplus框架中的UpdateStr函数,后面的章节中会介绍它。

六、字符串大小写转换

把字符串中的小写字母转换成大写,忽略不是字母的字符。

函数声明:

void ToUpper(char *str);   // 把字符串中的小写字母转换成大写,参数是C语言风格的char []。
void ToUpper(string &str); // 把字符串中的小写字母转换成大写,参数是C++语言风格的string。
void ToLower(char *str);   // 把字符串中的大写字母转换成小写,参数是C语言风格的char []。
void ToLower(string &str); // 把字符串中的大写字母转换成小写,参数是C++语言风格的string。

参数说明:

str:待转换的字符串,函数重载了char[]和string两种数据类型。

示例(demo12.cpp)

/*
 *  程序名:demo12.cpp,此程序演示freecplus框架中字符串大小写转换函数的使用。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
*/
#include "../_freecplus.h"
 
int main()
{
  char str1[31];   // C语言风格的字符串。
 
  STRCPY(str1,sizeof(str1),"12abz45ABz8西施。");
  ToUpper(str1);      // 把str1中的小写字母转换为大写。
  printf("str1=%s=\n",str1);    // 出输结果是str1=12ABZ45ABZ8西施。=
 
  STRCPY(str1,sizeof(str1),"12abz45ABz8西施。");
  ToLower(str1);      // 把str1中的大写字母转换为小写。
  printf("str1=%s=\n",str1);    // 出输结果是str1=12abz45abz8西施。=
 
  string str2;    // C++语言风格的字符串。
 
  str2="12abz45ABz8西施。";
  ToUpper(str2);      // 把str2中的小写字母转换为大写。
  printf("str2=%s=\n",str2.c_str());    // 出输结果是str2=12ABZ45ABZ8西施。=
 
  str2="12abz45ABz8西施。";
  ToLower(str2);      // 把str2中的大写字母转换为小写。
  printf("str2=%s=\n",str2.c_str());    // 出输结果是str1=12abz45abz8西施。=
}

七、字符串替换

把字符串中的内容替换成其它的内容,在字符串str中,如果存在字符串str1,就替换为字符串str2。

函数声明:

void UpdateStr(char *str,const char *str1,const char *str2,const bool bLoop=true);

参数说明:

str:待处理的字符串。

str1:旧的内容。

str2:新的内容。

bloop:是否循环执行替换。

注意:

1)如果str2比str1要长,替换后str会变长,所以必须保证str有足够的长度,否则内存会溢出。

2)如果str2中包函了str1的内容,且bloop为true,存在逻辑错误,将不执行任何替换。

示例(demo14.cpp)

/*
 *  程序名:demo14.cpp,此程序演示freecplus框架中字符串替换UpdateStr函数的使用。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
*/
#include "../_freecplus.h"
 
int main()
{
  char str[301];
 
  STRCPY(str,sizeof(str),"name:messi,no:10,job:striker.");
  UpdateStr(str,":","=");    // 把冒号替换成等号。
  printf("str=%s=\n",str);    // 出输结果是str1=name=messi,no=10,job=striker.=
 
  STRCPY(str,sizeof(str),"name:messi,no:10,job:striker.");
  UpdateStr(str,"name:","");    // 把"name:"替换成"",相当于删除内容"name:"。
  printf("str=%s=\n",str);    // 出输结果是str1=messi,no:10,job:striker.=
 
  STRCPY(str,sizeof(str),"messi----10----striker"); 
  UpdateStr(str,"--","-",false);    // 把两个"--"替换成一个"-",bLoop参数为false。
  printf("str=%s=\n",str);    // 出输结果是str1=messi--10--striker=
 
  STRCPY(str,sizeof(str),"messi----10----striker"); 
  UpdateStr(str,"--","-",true);    // 把两个"--"替换成一个"-",bLoop参数为true。
  printf("str=%s=\n",str);    // 出输结果是str1=messi-10-striker=
 
  STRCPY(str,sizeof(str),"messi-10-striker"); 
  UpdateStr(str,"-","--",false);    // 把一个"-"替换成两个"--",bLoop参数为false。
  printf("str=%s=\n",str);    // 出输结果是str1=messi--10--striker=
 
  STRCPY(str,sizeof(str),"messi-10-striker"); 
  // 以下代码把"-"替换成"--",bloop参数为true,存在逻辑错误,UpdateStr将不执行替换。
  UpdateStr(str,"-","--",true);    // 把一个"-"替换成两个"--",bloop参数为true。
  printf("str=%s=\n",str);    // 出输结果是str1=messi-10-striker=
}

八、从字符串中提取数字

从一个字符串中提取出数字、符号和小数点,存放到另一个字符串中。

函数声明:

void PickNumber(const char *src,char *dest,const bool bsigned,const bool bdot);

参数说明:

src:源字符串。

dest:目标字符串。

bsigned:是否包括符号(+和-),true-包括;false-不包括。

bdot:是否包括小数点的圆点符号,true-包括;false-不包括。

示例(demo16.cpp)

/*
 *  程序名:demo16.cpp,此程序演示freecplus框架中PickNumber函数的使用。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
*/
#include "../_freecplus.h"
 
int main()
{
  char str[26];   // 字符串str的大小是11字节。
 
  STRCPY(str,sizeof(str),"iab+12.3xy");
  PickNumber(str,str,false,false);
  printf("str=%s=\n",str);    // 出输结果是str=123=
 
  STRCPY(str,sizeof(str),"iab+12.3xy");
  PickNumber(str,str,true,false);
  printf("str=%s=\n",str);    // 出输结果是str=+123=
 
  STRCPY(str,sizeof(str),"iab+12.3xy");
  PickNumber(str,str,true,true);
  printf("str=%s=\n",str);    // 出输结果是str=+12.3=
}

九、正则表达式

正则表达式,判断一个字符串是否匹配另一个字符串。

函数声明:

bool MatchStr(const string str,const string rules);

参数说明:

str:需要判断的字符串,精确表示的字符串,如文件名"_freecplus.cpp"。

rules:匹配规则表达式,用星号"*"表示任意字符串,多个字符串之间用半角的逗号分隔,如"*.h,*.cpp"。

注意,str参数不支持"?",rules只支持"*",函数在判断str是否匹配rules的时候,会忽略字母的大小写。

示例(demo18.cpp)

/*
 *  程序名:demo18.cpp,此程序演示freecplus框架正则表达示MatchStr函数的使用。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
*/
#include "../_freecplus.h"
 
int main()
{
  char filename[301]; 
 
  STRCPY(filename,sizeof(filename),"_freecplus.h");
 
  // 以下代码将输出yes。
  if (MatchStr(filename,"*.h,*.cpp")==true) printf("yes\n");
  else printf("no\n");
 
  // 以下代码将输出yes。
  if (MatchStr(filename,"*.H")==true) printf("yes\n");
  else printf("no\n");
 
  // 以下代码将输出no。
  if (MatchStr(filename,"*.cpp")==true) printf("yes\n");
  else printf("no\n");
}

十、字符串的拆分

CCmdStr类用于拆分用分隔符分隔字段内容的字符串。

字符串的格式为:字段内容1+分隔符+字段内容2+分隔符+字段内容3+分隔符+....+字段内容n。

例如:"messi,10,striker,30,1.72,68.5,Barcelona",这是足球运动员梅西的资料,包括姓名、球衣号码、场上位置、年龄、身高、体重和效力的俱乐部,字段之间用半角的逗号分隔开。

CCmdStr类的声明:

// CCmdStr类用于拆分用分隔符分隔字段的字符串。
// 字符串的格式为:字段内容1+分隔符+字段内容2+分隔符+字段内容3+分隔符+...+字段内容n。
// 例如:"messi,10,striker,30,1.72,68.5,Barcelona",这是足球运动员梅西的资料,包括姓名、
// 球衣号码、场上位置、年龄、身高、体重和效力的俱乐部,字段之间用半角的逗号分隔开。
class CCmdStr
{
public:
  vector<string> m_vCmdStr;  // 存放拆分后的字段内容。
 
  CCmdStr();
 
  // 把字符串拆分到m_vCmdStr容器中。
  // buffer:待拆分的字符串。
  // sepstr:buffer字符串中字段内容的分隔符,注意,分隔符是字符串,如","、" "、"|"、"~!~"。
  // bdelspace:是否删除拆分后的字段内容前后的空格,true-删除;false-不删除,缺省删除。
  void SplitToCmd(const string buffer,const char *sepstr,const bool bdelspace=true);
 
  // 获取拆分后字段的个数,即m_vCmdStr容器的大小。
  int CmdCount();
 
  // 从m_vCmdStr容器获取字段内容。
  // inum:字段的顺序号,类似数组,从0开始。
  // value:传入变量的地址,用于存放字段内容。
  // 返回值:true-获取成功;false-获取失败。
  bool GetValue(const int inum,char   *value,const int ilen=0); // 字符串,ilen缺省值为0。
  bool GetValue(const int inum,int    *value); // int整数。
  bool GetValue(const int inum,unsigned int *value); // unsigned int整数。
  bool GetValue(const int inum,long   *value); // long整数。
  bool GetValue(const int inum,unsigned long *value); // unsigned long整数。
  bool GetValue(const int inum,double *value); // 双精度double。
  bool GetValue(const int inum,bool   *value); // bool型。
 
  ~CCmdStr();
};

示例(demo20.cpp)

/*
 *  程序名:demo20.cpp,此程序演示freecplus框架拆分字符串的类CCmdStr的使用。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
*/
#include "../_freecplus.h"
 
// 用于存放足球运动员资料的结构体。
struct st_player
{
  char name[51];    // 姓名
  char no[6];       // 球衣号码
  bool striker;     // 场上位置是否是前锋,true-是;false-不是。
  int  age;         // 年龄
  double weight;    // 体重,kg。
  long sal;         // 年薪,欧元。
  char club[51];    // 效力的俱乐部
}stplayer;
 
int main()
{
  memset(&stplayer,0,sizeof(struct st_player));
 
  char buffer[301]; 
  STRCPY(buffer,sizeof(buffer),"messi,10,true,30,68.5,2100000,Barcelona");
 
  CCmdStr CmdStr;
  CmdStr.SplitToCmd(buffer,",");        // 拆分buffer
  CmdStr.GetValue(0, stplayer.name,50); // 获取姓名
  CmdStr.GetValue(1, stplayer.no,5);    // 获取球衣号码
  CmdStr.GetValue(2,&stplayer.striker); // 场上位置
  CmdStr.GetValue(3,&stplayer.age);     // 获取年龄
  CmdStr.GetValue(4,&stplayer.weight);  // 获取体重
  CmdStr.GetValue(5,&stplayer.sal);     // 获取年薪,欧元。
  CmdStr.GetValue(6, stplayer.club,50); // 获取效力的俱乐部
 
  printf("name=%s,no=%s,striker=%d,age=%d,weight=%.1f,sal=%ld,club=%s\n",\
         stplayer.name,stplayer.no,stplayer.striker,stplayer.age,\
         stplayer.weight,stplayer.sal,stplayer.club);
  // 输出结果:name=messi,no=10,striker=1,age=30,weight=68.5,sal=21000000,club=Barcelona
}

十一、统计字符串的字数

统计字符串的字数,全角的汉字和全角的标点符号算一个字,半角的汉字和半角的标点符号也算一个字。

函数声明:

int Words(const char *str);

参数说明:

str:待统计的字符串。

返回值:字符串str的字数。

注意事项,本函数只适用用于Linux字符集为GBK的情况,在GB18030和Unicode编码中,汉字不一定是两个字节。

示例(demo21.cpp)

/*
 *  程序名:demo21.cpp,此程序演示freecplus框架的统计字符串字数的函数。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
*/
#include "../_freecplus.h"
 
int main()
{
  char buffer[301];
  STRCPY(buffer,sizeof(buffer),"messi,10,true,30,68.5,2100000,Barcelona。");
  printf("words=%d\n",Words(buffer)); // 输出结果:words=40
 
  STRCPY(buffer,sizeof(buffer),"梅西,10,true,30,68.5,2100000,Barcelona。");
  printf("words=%d\n",Words(buffer)); // 输出结果:words=37
}

十二、版权声明

C语言技术网原创文章,转载请说明文章的来源、作者和原文的链接。

来源:C语言技术网(www.freecplus.net

作者:码农有道

如果文章有错别字,或者内容有错误,或其他的建议和意见,请您联系我们指正,非常感谢!!!


C语言技术网(www.freecplus.net),粤ICP备19156379号

友情链接: 猿说编程    程序分享   

点击关闭