sscanf()格式化字符串用法

最新推荐文章于 2024-05-08 15:39:53 发布

不吃鱼的猫丿

最新推荐文章于 2024-05-08 15:39:53 发布

阅读量1.8k

点赞数

分类专栏： C

原文链接：www.etdev.net/thread-107-1-1.html

版权

C 专栏收录该内容

13 篇文章 2 订阅

订阅专栏

原文：https://www.etdev.net/thread-107-1-1.html

1. 概述

sscanf()为C语言标准库函数，用于从指定字符串中读入与指定格式相符的数据。函数原型声明在stdio.h头文件中：int sscanf(const char *str, const char *format, ...);

该函数根据参数format(格式化字符串)来转换参数str指向的字符串，转换后的结果存于对应的可变参数内。其返回值为按照指定格式转换符成功读入且赋值的可变参数数目(若发生匹配错误而部分成功，该数目会小于指定的参数数目，甚至为0)。若首次成功转换或错误匹配发生前输入已结束(如str为空字符串)，则返回EOF。发生读取错误时也返回EOF，且设置错误码errno(如format为空指针时返回EOF并设置errno为EINVAL)。可见，通过比较该函数的返回值与指定的可变参数数目，可判断格式转换是否成功。

format可为一个或多个{% [width] [{h | l | L}]type | ' ' | '\t' | '\n' | 非%符号}格式转换符。集合中{a|b|c}表示格式符a、b、c任选其一。以中括号括起来的格式符可选。%与type为必选，所有格式符必须以%开头。

2. 参数及格式符的含义

int sscanf(const char *str, const char *format, ...)

str -- 这是 C 字符串，是函数检索数据的源。

format -- 这是 C 字符串，包含了以下各项中的一个或多个：空格字符、非空格字符和 format 说明符。

format 说明符形式为 [=%[width][modifiers]type=]，具体讲解如下：

参数	描述
*	这是一个可选的星号，表示数据是从流 stream 中读取的，但是可以被忽视，即它不存储在对应的参数中。
width	这指定了在当前读取操作中读取的最大字符数。
modifiers	为对应的附加参数所指向的数据指定一个不同于整型（针对 d、i 和 n）、无符号整型（针对 o、u 和 x）或浮点型（针对 e、f 和 g）的大小： h ：短整型（针对 d、i 和 n），或无符号短整型（针对 o、u 和 x） l ：长整型（针对 d、i 和 n），或无符号长整型（针对 o、u 和 x），或双精度型（针对 e、f 和 g） L ：长双精度型（针对 e、f 和 g）
type	一个字符，指定了要被读取的数据类型以及数据读取方式。具体参见下一个表格。

1) 赋值抑制符 '*' 表明按照随后的转换符指示来读取输入，但将其丢弃不予赋值(“跳过”)。抑制符无需相应的指针可变参数，该转换也不计入函数返回的成功赋值次数。%*[width] [{h | l | L}]type 表示满足该条件的字符被过滤掉，不会向目标参数中赋值。

2) width表示最大读取宽度。当读入字符数超过该值，或遇到不匹配的字符时，停止读取。多数转换丢弃起始的空白字符。这些被丢弃的字符及转换结果添加的空结束符('\0')均不计入最大读取宽度。

3) {h | l | L}为类型修饰符。h指示输入的数字数值以short int或unsigned short int类型存储；hh指示输入以signed char或unsigned char类型存储。l(小写L)指示输入以long int、unsigned long int或double类型存储，若与%c或%s结合则指示输入以宽字符或宽字符串存储；ll等同L。L指示输入以long long类型存储。

两种特殊的格式符

1) []：字符集合。[]表示指定的字符集合匹配非空的字符序列；^则表示过滤。该操作不会跳过空白字符(空格、制表或换行符)，因此可用于目标字符串不以空白字符分隔时。[]内可有一到多个非^字符(含连字符'-')，且无顺序要求。%[a-z]表示匹配a到z之间的任意字符，%[aB-]匹配a、B、-中的任一字符；%[^a]则匹配非a的任意字符，即获取第一个a之前的(不为a的)所有字符。^可作用于多个条件，如^a-z=表示^a-z且^=(既非小写字母亦非等号)。空字符集%[]和%[^]会导致不可预知的结果。

使用[]时接收输入的参数必须是有足够存储空间的char、signed char或unsigned char数组。[]也是转换符，故%[]后无s。

%[^]的含义和用法与正则表达式相同，故sscanf函数某种程度上提供了简单的正则表达式功能。

2) n：至此已读入值(未必赋值)的等价字符数，该数目必须以int类型存储。如"10,22"经过"%d%*[^0-9]%n"格式转换后，%n对应的参数值为3(虽然','未参与赋值)。

'n'并非转换符，尽管它可用'*'抑制。C标准声称，执行%n指令并不增加函数返回的赋值次数；但其勘误表中的描述与之矛盾。建议不要假设%n对返回值的影响。

sscanf 类型说明符：

类型	合格的输入	参数的类型
c	单个字符：读取下一个字符。如果指定了一个不为 1 的宽度 width，函数会读取 width 个字符，并通过参数传递，把它们存储在数组中连续位置。在末尾不会追加空字符。	char *
d	十进制整数：数字前面的 + 或 - 号是可选的。	int *
e,E,f,g,G	浮点数：包含了一个小数点、一个可选的前置符号 + 或 -、一个可选的后置字符 e 或 E，以及一个十进制数字。两个有效的实例 -732.103 和 7.12e4	float *
o	八进制整数。	int *
s	字符串。这将读取连续字符，直到遇到一个空格字符（空格字符可以是空白、换行和制表符）。	char *
u	无符号的十进制整数。	unsigned int *
x,X	十六进制整数。	int *