C库函数 int fscanf(FILE *stream, const char *format, ...) 从流中读取的格式输入。
声明
以下是 fscanf() 函数的声明。
int fscanf(FILE *stream, const char *format, ...)
参数
-
stream -- 这是一个文件对象的标识流的指针。
-
format -- 这是C字符串,其中包含一个或多个以下项目:空白字符,非空白字符和格式说明符。格式规范将 [=%[*][width][modifiers]type=], 详细说明如下:
参数 | 描述 |
---|---|
* | 这是一个可选的星号表示该数据是从流中被读取的,但忽略,即,它不会存储在相应的参数。 |
width | 这指定在当前读出操作被读取的最大字符数 |
modifiers | Specifies a size different from int (in the case of d, i and n), unsigned int (in the case of o, u and x) or float (in the case of e, f and g) for the data yiibaied by the corresponding additional argument: h : short int (for d, i and n), or unsigned short int (for o, u and x) l : long int (for d, i and n), or unsigned long int (for o, u and x), or double (for e, f and g) L : long double (for e, f and g) |
type | 的字符,指定将要读取的数据的类型以及它是如何被读取。请参阅下表。 |
fscanf类型说明:
类型 | 合格输入 | 参数类型 |
---|---|---|
c | Single character: Reads the next character. If a width different from 1 is specified, the function reads width characters and stores them in the successive locations of the array passed as argument. No null character is appended at the end. | char * |
d | Decimal integer: Number optionally preceeded with a + or - sign | int * |
e,E,f,g,G | Floating yiibai: Decimal number containing a decimal yiibai, optionally preceeded by a + or - sign and optionally folowed by the e or E character and a decimal number. Two examples of valid entries are -732.103 and 7.12e4 | float * |
o | OctalInteger: | int * |
s | String of characters. This will read subsequent characters until a whitespace is found (whitespace characters are considered to be blank, newline and tab). | char * |
u | Unsigned decimal integer. | unsigned int * |
x,X | Hexadecimal Integer | int * |
-
additional arguments -- 根据格式字符串,函数可能会想到一系列的额外的参数,每个包含一个值,而不是插入的格式参数中指定的标记每个%,如果有的话。应该有相同数量的%预期值的标签的数量的这些参数。
返回值
此函数返回成功匹配,分配的输入项目的数量,它可以是少于提供了在一个早期的匹配失败的情况下,甚至可以为零。
例子
下面的例子演示了如何使用fscanf() 函数。
#include <stdio.h> #include <stdlib.h> int main() { char str1[10], str2[10], str3[10]; int year; FILE * fp; fp = fopen ("file.txt", "w+"); fputs("We are in 2012", fp); rewind(fp); fscanf(fp, "%s %s %s %d", str1, str2, str3, &year); printf("Read String1 |%s| ", str1 ); printf("Read String2 |%s| ", str2 ); printf("Read String3 |%s| ", str3 ); printf("Read Integer |%d| ", year ); fclose(fp); return(0); }
让我们编译和运行上面的程序,这将产生以下结果:
Read String1 |We| Read String2 |are| Read String3 |in| Read Integer |2012|