名称
fgetc，fgets，getc，getchar，ungetc – 字符和字符串的输入
概要
#include <stdio.h>
int fgetc(FILE *stream);
char *fgets(char *s, int size, FILE *stream);
int getc(FILE *stream);
int getchar(void);
int ungetc(int c, FILE *stream);
说明
fgetc从流中读取下一个字符，对该字符做unsigned char转int的类型转换操作之
后返回，如果到达文件结尾则返回EOF，也有可能因出错返回。
getc跟fgetc一样，除此之外它还可以被实现为一个宏定义用于多次测试流。
getchar等效于参数为stdin的getc。
fgets从stream中至多读取size-1个字符，并且把它们保存在s指向的缓冲区中。
当读入EOF或者换行符之后则停止读取，如果已经读入了换行符，那么换行符也
保存在缓冲区中。缓冲区内最后一个字符的后面自动追加一个结束符（’\0’）。
ungetc将参数c转换为unsigned char类型之后回退给stream，随后的读操作可以
获取到回退的内容，连续地调用ungetc将以逆序的方式把字符回退到流中。
上述的函数可以混合调用，也可以和I/O库中的其他输入函数混合调用。
关于非阻塞的实现，参考unlocked_stdio。
返回值
fgetc，getc，getchar返回unsigned char转为int类型之后的值，或者到达文件结
尾则返回EOF，也有可能因出错返回。
fgets成功时返回参数s，出错时返回NULL，到达文件结尾时也返回NULL。
ungetc成功时返回参数c，出错时返回EOF。
线程安全特征
标准
遵循POSIX.1-2001, POSIX.1-, C89, C99。
上述的函数和底层的read函数混合调用是不明智的、结果是未定义的而且往往是
非预期的。
推荐阅读
read，write，ferror，fgetwc，fgetws，fopen，fread，fseek，getline，gets，getwchar，
puts，scanf，ungetwc，unlocked_stdio，feature_test_macros
版本记录
这个页面是Linux man-pages项目4.04版本的一部分。关于该项目的信息和bug
报道可以在该网站找到：/doc/man-pages/。
-08-08
