C函数--sscanf

sscanf 读取格式化的字符串中的数据。

swscanf 是 sscanf 的宽字符版本；swscanf 的参数是宽字符串。 swscanf不处理 Unicode 全角十六进制或"兼容性区"字符。 除此以外，swscanf 和 sscanf 的行为完全相同。 [1] 

外文名

sscanf

类    别

C 数据输入

解    释

字符串中读进相符的数据

参    数

宽字符串

目录

1. 1 函数语法
2. 2 参数
3. 3 要求
4. 4 说明

1. 5 返回值
2. 6 作用
3. 7 使用实例
4. 8 例程

1. ▪ 代码
2. ▪ 输出
3. 9 集合操作
4. 10 小结

函数语法

编辑

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

[1] 

参数

编辑

buffer
　　存储的数据

format
　　窗体控件字符串。 有关详细信息，请参阅"格式规范"。

argument
　　可选自变量

locale
　　要使用的区域设置 [1] 

要求

编辑

例程	必须的头文件
sscanf	<stdio.h>
_sscanf_l
swscanf	<stdio.h> <wchar.h>
_swscanf_l

[1] 

说明

编辑

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

第二个参数可以是一个或多个 {%[*] [width] [{h | I | I64 | L}]type | ' ' | '\t' | '\n' | 非%符号}

注：

1、 * 亦可用于格式中, (即 %*d 和 %*s) 加了星号 (*) 表示跳过此数据不读入. (也就是不把此数据读入参数中)

2、{a|b|c}表示a,b,c中选一，[d],表示可以有d也可以没有d。

3、width表示读取宽度。

4、{h | l | I64 | L}:参数的size,通常h表示单字节size，I表示2字节 size,L表示4字节size(double例外),l64表示8字节size。

5、type :这就很多了，就是%s,%d之类。

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

失败返回0 ，否则返回格式化的参数个数

7、如果读取的字符串，不是以空格来分隔的话，就可以使用%[]。

返回值

编辑

函数将返回成功赋值的字段个数；返回值不包括已读取但未赋值的字段个数。 返回值为 0 表示没有将任何字段赋值。 如果在第一次读取之前到达字符串结尾，则返回EOF。

如果buffer或format是NULL调用指针，无效参数处理程序，如中所述参数验证。 如果允许继续执行，则这些函数返回 -1 并将errno设置为EINVAL。

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

经多次测试[来源请求]，在linux系统中成功返回的是成功转换的值的个数，例如：

sscanf("1 2 3","%d %d %d",buf1, buf2, buf3); 成功调用返回值为3，即buf1，buf2，buf3均成功转换。

sscanf("1 2","%d %d %d",buf1, buf2, buf3); 成功调用返回值为2，即只有buf1，buf2成功转换。

(注意：此处buf均为地址)

有关这些和其他错误代码的信息，请参阅_doserrno、 errno、 _sys_errlist 和 _sys_nerr。 [1] 

作用

编辑

读取格式化的字符串中的数据。

P.S. 这些函数的更安全版本才会有效。请参阅sscanf_s、 _sscanf_s_l、 swscanf_s、 _swscanf_s_l。 [1] 

使用实例

编辑

1、一般用法

1 2 3

char buf[512] = ; sscanf("123456 ", "%s", buf); printf("%s\n", buf);

结果为：123456
　　2. 取指定长度的字符串。如在下例中，取最大长度为4字节的字符串。

1 2	sscanf("123456 ", "%4s", buf); printf("%s\n", buf);

结果为：1234
　　3. 取到指定字符为止的字符串。如在下例中，取遇到空格为止字符串。

1 2	sscanf("123456 abcdedf", "%[^ ]", buf); printf("%s\n", buf);

结果为：123456
　　4. 取仅包含指定字符集的字符串。如在下例中，取仅包含1到9和小写字母的字符串。

1 2	sscanf("123456abcdedfBCDEF", "%[1-9a-z]", buf); printf("%s\n", buf);

结果为：123456abcdedf
　　5. 取到指定字符集为止的字符串。如在下例中，取遇到大写字母为止的字符串。

1 2	sscanf("123456abcdedfBCDEF", "%[^A-Z]", buf); printf("%s\n", buf);

结果为：123456abcdedf
　　6、给定一个字符串iios/12DDWDFF@122，获取 / 和 @ 之间的字符串，先将 "iios/"过滤掉，再将非'@'的一串内容送到buf中

1 2	sscanf("iios/12DDWDFF@122", "%*[^/]/%[^@]", buf); printf("%s\n", buf);

结果为：12DDWDFF
　　7、给定一个字符串"hello, world"，仅保留"world"。（注意：“，”之后有一空格）

1 2	sscanf("hello, world", "%*s%s", buf); printf("%s\n", buf);

结果为：world
　　P.S. %*s表示第一个匹配到的%s被过滤掉，即hello被过滤了，
　　如果没有空格则结果为NULL。 [2] 

例程

编辑

代码

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26

//Compiled with Visual Studio 2015. //================Original File===================*/ // crt_sscanf.c   // compile with: /W3   // This program uses sscanf to read data items   // from a string named tokenstring, then displays them.    # include <stdio.h>     int main( void )  {      char  tokenstring[] = "15 12 14...";      char  s[81];      char  c;      int   i;      float fp;        // Input various data from tokenstring:      // max 80 character string:      sscanf( tokenstring, "%80s", s ); // C4996      sscanf( tokenstring, "%c", &c );  // C4996      sscanf( tokenstring, "%d", &i );  // C4996      sscanf( tokenstring, "%f", &fp ); // C4996      // Note: sscanf is deprecated; consider using sscanf_s instead        // Output the data read      printf( "String    = %s\n", s );      printf( "Character = %c\n", c );      printf( "Integer:  = %d\n", i );      printf( "Real:     = %f\n", fp );   }

输出

1	String    = 15  Character = 1  Integer:  = 15  Real:     = 15.000000

[1] 

集合操作

编辑

%[a-z] 表示匹配a到z中任意字符，贪婪性(尽可能多的匹配)

%[aB'] 匹配a、B、'中一员，贪婪性

%[^a] 匹配非a的任意字符，并且停止读入，贪婪性

小结

编辑

sscanf的功能很类似于正则表达式, 但却没有正则表达式强大,所以如果对于比较复杂的字符串处理,建议使用正则表达式。 [2]