RT-thread之vsscanf()函数

项目终于进行到了通讯的部分，用的是有人的GM5模块，虽属于简单模块，但要真架接到rt-thread中间还是遇到些坑，一个个都解决了，事后总结还是没仔细看《编程指南》，要是真搞明白里面所说的，应该也走不了这么多的弯路。在rt-thread中提到一个sscanf(),这个是在没接触之前，没接触过的函数，有什么用呢？如下图：

 

sscanf(): 从字符串中读取指定格式的数据

sscanf()函数用于从字符串中读取指定格式的数据，其原型如下：
  

1	int sscanf (char *str, char * format [, argument, ...]);

【参数】参数str为要读取数据的字符串；format为用户指定的格式；argument为变量，用来保存读取到的数据。

【返回值】成功则返回参数数目，失败则返回-1，错误原因存于errno 中。

sscanf()会将参数str 的字符串根据参数format（格式化字符串）来转换并格式化数据（格式化字符串请参考scanf()）， 转换后的结果存于对应的变量中。

sscanf()与scanf()类似，都是用于输入的，只是scanf()以键盘(stdin)为输入源，sscanf()以固定字符串为输入源。

其中的format可以是一个或多个{%[*][width][size]type |' '|'\t'|'\n'|非%符号}
%：代表要读入一个字符集
注：
1、*亦可用于格式中,(即%*d 和%*s)加了星号(*)表示跳过此数据不读入.(也就是不把此数据读入参数中)
2、{a|b|c}表示a,b,c中选一，[d],表示可以有d也可以没有d。
3、width表示读取宽度。
4、参数的size:常用的有hh表示单字节size，h表示2字节 size，其他详见man sscanf或msdn
5、type :这就很多了，就是%s,%d之类。
控制字符说明
%c 一个单一的字符
%d 一个十进制整数
%i 一个整数
%e,%f,%g 一个浮点数
%o 一个八进制数
%s 一个字符串
%x 一个十六进制数
%p 一个指针
%n 一个等于读取字符数量的整数
%u 一个无符号整数
%[]一个字符集  区别于前面可有可无的[]部分
%%一个精度符


6、特别的：%*[width][{h | l | I64 | L}]type 表示满足该条件的被过滤掉，不会向目标参数中写入值

%[a-z] 读取在 a-z 之间的字符串，如果不在此之前则停止，如
char s[]="hello, my friend” ; // 注意: ,逗号在不 a-z之间
sscanf( s, “%[a-z]”, string ) ; // string=hello

%[^a-z] 读取不在 a-z 之间的字符串，如果碰到a-z之间的字符则停止，如
char s[]="HELLOkitty” ; // 注意: ,逗号在不 a-z之间
sscanf( s, “%[^a-z]”, string ) ; // string=HELLO

%*[^=] 前面带 * 号表示不保存变量。跳过符合条件的字符串。
char s[]="notepad=1.0.0.1001" ;
char szfilename [32] = "" ;
int i = sscanf( s, "%*[^=]", szfilename ) ;// szfilename=NULL,因为没保存
intj = sscanf( s, "%*[^=]=%s", szfilename ) ;// szfilename=1.0.0.1001

%40c 读取40个字符
%[^=] 读取字符串直到碰到'='号，'^'后面可以带更多字符,如：
char s[]="notepad=1.0.0.1001" ;
char szfilename [32] = "" ;
int i = sscanf( s, "%[^=]", szfilename ) ;           // szfilename=notepad
如果参数格式是：%[^=:] ，那么也可以从 notepad:1.0.0.1001读取notepad

可以看到format参数有些类似正则表达式（当然没有正则表达式强大，复杂字符串建议使用正则表达式处理），支持集合操作，例如：

•     %[a-z] 表示匹配a到z中任意字符，贪婪性(尽可能多的匹配)
•     %[aB'] 匹配a、B、'中一员，贪婪性
•     %[^a] 匹配非a的任意字符，贪婪性
•  
• 另外，format不仅可以用空格界定字符串，还可以用其他字符界定，可以实现简单的字符串分割（更加灵活的字符串分割请使用strtok()）。例如：

  sscanf("2006:03:18", "%d:%d:%d", a, b, c);
  sscanf("2006:03:18 - 2006:04:18", "%s - %s", sztime1, sztime2);

如下例子

#include<stdio.h>
int main()
{
char buf[512]={0};
//1. 常见用法。
sscanf("123456 asdf","%s", buf);
printf("%s\n", buf);
printf("123456 Expect! %%s\n\n");
//结果为：123456
//2. 取指定长度的字符串。如在下例中，取最大长度为4字节的字符串。
sscanf("123456 ","%4s", buf);
printf("%s\n", buf);
printf("1234 Expect! %%4s\n\n");
//结果为：1234
//3. 取到指定字符为止的字符串。如在下例中，取遇到空格为止字符串。
sscanf("123456 abcdedf","%[^ ]", buf);
printf("%s\n", buf);
printf("123456 Expect! %%[^ ]\n\n");
//结果为：123456
//4. 取仅包含指定字符集的字符串。如在下例中，取仅包含1到9和小写字母的字符串。
sscanf("123456abcdedfBCDEFxyz","%[1-9a-z]", buf);
printf("%s\n", buf);
printf("123456abcdedf Expect! %%[1-9a-z]\n\n");
//结果为：123456abcdedf
//5. 取到指定字符集为止的字符串。如在下例中，取遇到大写字母为止的字符串。
sscanf("123456 abcdedfBCDEFxyz","%[^A-Z]", buf);
printf("%s\n", buf);
printf("123456 abcdedf Expect! %%[^A-Z]\n\n");
//结果为：123456 abcdedf
//6、给定一个字符串iios/12DDWDFF@122，获取 / 和 @ 之间的字符串，先将 "iios/"过滤掉，再将非'@'的一串内容送到buf中
sscanf("iios/12DDWDFF@122","%*[^/]/%[^@]", buf);1.星号为了忽略非/之前的   2.多加一个/将其过滤
printf("%s\n", buf);
printf("12DDWDFF Expect! %%*[^/]/%%[^@]\n\n");
//结果为：12DDWDFF
//7、给定一个字符串““hello, world”，仅保留world。（注意：“，”之后有一空格）
sscanf("hello, world","%*s%s", buf);
printf("%s\n", buf);
printf("world Expect! %%*s%%s\n\n");
//结果为：world  没有逗号
//8、参数size的控制
unsignedchar m[6]={0};
int n =0;
// sscanf 返回输入了几个参数
n = sscanf("010203040506","%hhx%hhx%hhx%hhx%hhx%hhx",&m[0],&m[1],&m[2],&m[3],&m[4],&m[5]);
printf("hhx: %d :%02x%02x%02x%02x%02x%02x\n",n, m[0], m[1],m[2],m[3], m[4], m[5]);
// 结果 n 为 1， 因为 hhx 把所有字符串作为一个数字，后面的都没有输入
n = sscanf("010203040506","%2hhx%2hhx%2hhx%2hhx%2hhx%2hhx",&m[0],&m[1],&m[2],&m[3],&m[4],&m[5]);
printf("2hhx: %d :%02x%02x%02x%02x%02x%02x\n",n, m[0], m[1],m[2],m[3], m[4], m[5]);
// 结果 n 为 6， 加了2，之后限制每次hhx只匹配2个字符，所以每个都被输入
n = sscanf("010203040506","%02x%02x%02x%02x%02x%02x",&m[0],&m[1],&m[2],&m[3],&m[4],&m[5]);
printf(" 02x: %d :%02x%02x%02x%02x%02x%02x\n",n, m[0], m[1],m[2],m[3], m[4], m[5]);
// 0 是填充字符，2表示匹配2个字符，x表示一个十六进制数
// 注意：编译有warning，有时结果是正确的（跟具体的编译器、编译选项、编译环境有关），但x表示4个字节，大于被输入对象的大小
// 这会导致相邻的3个字节会被覆盖！！这会导致分配在相邻内存的变量被清0
//http://blog.csdn.net/rainharder/archive/2008/09/27/2989675.aspx里面有个覆盖的例子
return0;
}

 

vsscanf()函数：字符串输入函数

头文件：

1	#include <stdio.h>

定义函数：

1	int vsscanf(const char * str, const char * format, va_list ap);

函数说明：vsscanf()会将参数str 的字符串根据参数format 字符串来转换并格式化数据.

返回值：成功则返回参数数目, 失败则返回-1, 错误原因存于errno 中.

 

C语言vscanf()函数：字符串格式化输入函数
头文件：

1	#include <stdio.h>  #include <stdarg.h>

定义函数：

1	int vscanf(const char * format, va_list ap);

函数说明：vscanf()会将输入的数据根据参数format 字符串来转换并格式化数据. 格式转换形式请参考scanf(). 转换后的结果存于对应的参数内.
返回值成功则返回参数数目, 失败则返回-1, 错误原因存于errno 中。