scanf

scanf 原型：

# include ;
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。这些类型在 ; 中声明，并说明最大宽度的整数。
    z 格式修饰符应用于 d、i、o、u、x、X 或 n，说明匹配的变元是指向 size_t 类型对象的指针。该类型在 ; 中声明，并说明 sizeof 的结构。
    t 格式修饰符应用于 d、i、o、u、x、X 或 n，说明匹配的变元是指向 ptrdiff_t  类型对象的指针。该类型在 ; 中声明，并说明两个指针之间的差别。


例子：

# include ;

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()。