C 庫函數– sscanf()
描述
C庫函數int sscanf(const char *str, const char *format, ...)從字符串讀取格式化輸入。
聲明
下面是sscanf() 函數的聲明。
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 | 一个字符,指定了要被读取的数据类型以及数据读取方式。具体参见下一个表格。 |
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 * |
- 附加參數 --這個函數接受一系列的指針作為附加參數,每一個指針都指向一個對象,對像類型由format字符串中相應的%標籤指定,參數與%標籤的順序相同。
針對檢索數據的format 字符串中的每個format 說明符,應指定一個附加參數。 如果您想要把sscanf 操作的結果存儲在一個普通的變量中,您應該在標識符前放置引用運算符(&),例如:
int n; sscanf (str,"%d",&n);
返回值
如果成功,該函數返回成功匹配和賦值的個數。 如果到達文件末尾或發生讀錯誤,則返回EOF。
實例
下面的實例演示了sscanf() 函數的用法。
#include <stdio.h> #include <stdlib.h> int main() { int day, year; char weekday[20], month[20], dtm[100]; strcpy( dtm, "Saturday March 25 1989" ); sscanf( dtm, "%s %s %d %d", weekday, month, &day, &year ); printf("%s %d, %d = %s\n", month, day, year, weekday ); return(0); }
讓我們編譯並運行上面的程序,這將產生以下結果:
March 25, 1989 = Saturday