# include <stdio.h>;
int scanf( const char *format, ... );
函数 scanf() 是从标准输入流 stdin 中读内容的通用子程序,可以读入全部固有类型的数据并自动转换成机内形式。scanf() 是 printf() 的补函数。
在 C99 中,format 用 restrict 修饰。
format 指向的控制串由以下三类字符组成:
● 格式说明符
● 空白符
● 非空白符
输入格式说明符前缀为百分号(%),告诉 scanf() 下次读入何种数据类型。这些格式说明符的清单如下表所示:
┏━━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ 代 码 │ 意 义 ┃
┠────┼────────────────────────────┨
┃ %a │读浮点值(仅适用于 C99) ┃
┃ %A │读浮点值(仅适用于 C99) ┃
┃ %c │读单字符 ┃
┃ %d │读十进制整数 ┃
┃ %i │读十进制、八进制、十六进制整数 ┃
┃ %e │读浮点数 ┃
┃ %E │读浮点数 ┃
┃ %f │读浮点数 ┃
┃ %F │读浮点数(仅适用于 C99) ┃
┃ %g │读浮点数 ┃
┃ %G │读浮点数 ┃
┃ %o │读八进制数 ┃
┃ %s │读字符串 ┃
┃ %x │读十六进制数 ┃
┃ %X │读十六进制数 ┃
┃ %p │读指针值 ┃
┃ %n │至此已读入值的等价字符数 ┃
┃ %u │读无符号十进制整数 ┃
┃ %[ ] │扫描字符集合 ┃
┃ %% │读 % 符号(百分号) ┃
┗━━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
例如: %s 表示读串而 %d 表示读整数。格式串的处理顺序为从左到右,格式说明符逐一与变元表中的变元匹配。为了读取长整数,可以将
l(ell) 放在格式说明符的前面;为了读取短整数,可以将 h 放在格式说明符的前面。这些修饰符可以与 d、i、o、u 和 x
格式代码一起使用。
默认情况下,a、f、e 和 g 告诉 scanf() 为 float 分配数据。 如果将
l(ell) 放在这些修饰符的前面,则 scanf() 为 double 分配数据。使用 L 就是告诉 scanf(),接收数据的变量是
long double 型变量。
如果使用的现代编译器程序支持 1995 年增加的宽字符特性, 则可以与 c
格式代码一起,用 l 修饰符说明类型 wchar_t 的宽字符指针;也可以与 s 格式代码一起,用 l 修饰符说明宽字符串的指针。l
修饰符也可以用于修饰扫描集,以说明宽字符。
控制串中的空白符使 scanf() 在输入流中跳过一个或多个空白行。空白符可以是空格(space)、制表符(tab)和新行符(newline)。 本质上,控制串中的空白符使 scanf() 在输入流中读,但不保存结果,直到发现非空白字符为止。
非空白符使 scanf() 在流中读一个匹配的字符并忽略之。例如,"%d,%d" 使 scanf() 先读入一个整数,读入中放弃逗号,然后读另一个整数。如未发现匹配,scanf() 返回。
scanf() 中用于保存读入值的变元必须都是变量指针,即相应变量的地址。
在输入流中,数据项必须由空格、制表符和新行符分割。逗号和分号等不是分隔符,比如以下代码:
scanf( "%d %d", &r, &c );
将接受输入 10 20,但遇到 10,20 则失败。
百分号(%)与格式符之间的星号(*)表示读指定类型的数据但不保存。因此,
scanf( "%d %*c %d", &x, &y );
对 10/20 的读入操作中,10 放入变量 x,20 放入 y。
格式命令可以说明最大域宽。 在百分号(%)与格式码之间的整数用于限制从对应域读入的最大字符数。例如,希望向 address 读入不多于 20 个字符时,可以书写成如下形式:
scanf( "%20s", address );
如果输入流的内容多于 20 个字符,则下次 scanf() 从此次停止处开始读入。 若达到最大域宽前已遇到空白符,则对该域的读立即停止;此时,scanf() 跳到下一个域。
虽然空格、制表符和新行符都用做域分割符号,但读单字符操作中却按一般字符处理。例如,对输入流 "x y" 调用:
scanf( "%c%c%c", &a, &b, &c );
返回后,x 在变量 a 中,空格在变量 b 中,y 在变量 c 中。
注意,控制串中的其它字符,包括空格、制表符和新行符,都用于从输入流中匹配并放弃字符,被匹配的字符都放弃。例如,给定输入流 "10t20",调用:
scanf( "%dt%d", &x, &y );
将把 10 和 20 分别放到 x 和 y 中,t 被放弃,因为 t 在控制串中。
ANSI C 标准向 scanf() 增加了一种新特性,称为扫描集(scanset)。 扫描集定义一个字符集合,可由 scanf()
读入其中允许的字符并赋给对应字符数组。 扫描集合由一对方括号中的一串字符定义,左方括号前必须缀以百分号。 例如,以下的扫描集使 scanf()
读入字符 A、B 和 C:
%[ABC]
使用扫描集时,scanf() 连续吃进集合中的字符并放入对应的字符数组,直到发现不在集合中的字符为止(即扫描集仅读匹配的字符)。返回时,数组中放置以 null 结尾、由读入字符组成的字符串。
用字符 ^ 可以说明补集。把 ^ 字符放为扫描集的第一字符时,构成其它字符组成的命令的补集合,指示 scanf() 只接受未说明的其它字符。
对于许多实现来说,用连字符可以说明一个范围。 例如,以下扫描集使 scanf() 接受字母 A 到 Z:
%[A-Z]
重要的是要注意扫描集是区分大小写的。因此,希望扫描大、小写字符时,应该分别说明大、小写字母。
scanf() 返回等于成功赋值的域数的值,但由于星号修饰符而读入未赋值的域不计算在内。给第一个域赋值前已出错时,返回 EOF。
C99 为 scanf() 增加了几个格式修饰符:hh、ll、j、z 和 t。hh 修饰符可用于 d、i、o、u、x、X 或
n。它说明相应的变元是 signed 或 unsigned char 值,或用于 n 时, 相应的变元是指向 long char
型变量的指针。ll 修饰符也可用于 d、i、o、u、x、X 或 n。它说明相应的变元是 signed 或者 unsigned long
long int 值。
j 格式修饰符应用于 d、i、o、u、x、X 或 n,说明匹配的变元是类型 intmax_t 或 uintmax_t。这些类型在 <stdint.h>; 中声明,并说明最大宽度的整数。
z 格式修饰符应用于 d、i、o、u、x、X 或 n,说明匹配的变元是指向 size_t 类型对象的指针。该类型在 <stddef.h>; 中声明,并说明 sizeof 的结构。
t 格式修饰符应用于 d、i、o、u、x、X 或 n,说明匹配的变元是指向 ptrdiff_t 类型对象的指针。该类型在 <stddef.h>; 中声明,并说明两个指针之间的差别。
例子:
# include <stdio.h>;
int main( void )
{
char str[80], str2[80];
int i;
/* read a string and a integer */
scanf( "%s%d", str, &i );
/* read up to 79 chars into str */
scanf( "%79s", str );
/* skip the integer between the two strings */
scanf( "%s%*d%s", str, str2 );
return 0;
}
相关函数:
printf() 及 fscanf()。