C /C++标准库 - <cstdio>(stdio.h)

C 标准库 -

1. 库变量

序号 变量 描述 1 size_t 这是无符号整数类型，它是 sizeof 关键字的结果。 2 FILE 这是一个适合存储文件流信息的对象类型。 3 fpos_t 这是一个适合存储文件中任何位置的对象类型。

2. 宏定义

下面是头文件 stdio.h 中定义的宏：

序号 宏 描述 1 NULL 这个宏是一个空指针常量的值 2 _IOFBF、_IOLBF 和 _IONBF 这些宏扩展了带有特定值的整型常量表达式，并适用于 setvbuf 函数的第三个参数。 3 BUFSIZ 这个宏是一个整数，该整数代表了 setbuf 函数使用的缓冲区大小。 4 EOF End-of-File 5 FOPEN_MAX 这个宏是一个整数，该整数代表了系统可以同时打开的文件数量。 6 FILENAME_MAX 这个宏是一个整数，该整数代表了字符数组可以存储的文件名的最大长度。如果实现没有任何限制，则该值应为推荐的最大值。 7 L_tmpnam 这个宏是一个整数，该整数代表了字符数组可以存储的由 tmpnam 函数创建的临时文件名的最大长度。 8 SEEK_CUR、SEEK_END 和 SEEK_SET 这些宏是在These macros are used in the fseek 函数中使用，用于在一个文件中定位不同的位置。 9 TMP_MAX 这个宏是 tmpnam 函数可生成的独特文件名的最大数量。 10 stderr、stdin 和 stdout 这些宏是指向 FILE 类型的指针，分别对应于标准错误、标准输入和标准输出流。

3. 库函数

3.1 Operations on files:

序号 函数 描述 补充描述 1 int remove ( const char * filename ); Deletes the file whose name is specified in filename.（永久删除文件） 操作成功，返回0，否则返回非零 2 int rename ( const char * oldname, const char * newname ); Changes the name of the file or directory specified by oldname to newname. 同上 3 FILE * tmpfile ( void ); 以二进制更新模式(wb+)创建临时文件 成功，返回临时文件， failure, NULL is returned. 4 char * tmpnam ( char * str ); 生成并返回一个有效的临时文件名，该文件名之前是不存在的。 成功，返回文件名，失败，返回NULL

3.2 File access:

序号 函数 描述 补充描述 1 int fclose ( FILE * stream ); 关闭流 stream。刷新所有的缓冲区。 success,return 0,fail,return EOF 2 FILE * fopen ( const char * filename, const char * mode ); 使用给定的模式 mode 打开 filename 所指向的文件 success,return FILE*,fail,return NULL 3 FILE * freopen ( const char * filename, const char * mode, FILE * stream ); 把一个新的文件名 filename 与给定的打开的流 stream 关联，同时关闭流中的旧文件。 同上 4 int fflush ( FILE * stream ); 刷新流 stream 的输出缓冲区。 成功，返回0，失败返回EOF 5 void setbuf ( FILE * stream, char * buffer ); 自定义控制流的缓冲 6 int setvbuf ( FILE * stream, char * buffer, int mode, size_t size ); 自定义缓冲流及缓冲模式 成功，返回0，失败返回非零

3.3 Formatted input/output:

序号 标签 函数原语 描述 补充描述 1 fprintf int fprintf ( FILE * stream, const char * format, … ); 格式化输出到指定流 成功，返回写入的字符总数，否则返回负数 2 printf int printf ( const char * format, … ); 格式化输出到标准输出流stdout 成功，返回写入的字符总数，否则返回负数 3 sprintf int sprintf ( char * str, const char * format, … ); 格式化输出到字符串缓冲区，并自动在末尾添加字符串结尾标识符’\0’ 成功，返回写入的字符总数（不包括自动添加的’\0’),否则，返回负数 4 snprintf (C99) int snprintf ( char * s, size_t n, const char * format, … ); 格式化输出到字符串缓冲区，并自动在末尾添加字符串结尾标识符’\0’(设置单词最大写入字符个数） 成功，返回写入的字符总数（不包括自动添加的’\0’),否则，返回负数 5 fscanf int fscanf ( FILE * stream, const char * format, … ); Read formatted data from stream 成功，返回成功填充的变量总数，失败返回EOF 6 scanf int scanf ( const char * format, … ); Read formatted data from stdin 同上 7 sscanf int sscanf ( const char * s, const char * format, …); Read formatted data from string 同上

可变参数操作函数：

序号 标签 描述 1 vfprintf Write formatted data from variable argument list to stream 2 vfscanf Read formatted data from stream into variable argument list 3 vprintf Print formatted data from variable argument list to stdout 4 vscanf Read formatted data into variable argument list 5 vsnprintf Write formatted data from variable argument list to sized buffer 6 vsprintf Write formatted data from variable argument list to string 7 vsscanf Read formatted data from string into variable argument list

3.4 Character input/output:

序号 标签 函数原语 描述 补充描述 1 fgetc int fgetc ( FILE * stream ); Get character from stream 成功，返回字符的ASCII码，否则返回EOF 2 getc int getc ( FILE * stream ); 同上 getc and fgetc are equivalent, except that getc may be implemented as a macro in some libraries 3 getchar int getchar ( void ); Get character from stdin 成功，返回字符的ASCII码，否则返回EOF 4 fgets char * fgets ( char * str, int num, FILE * stream ); Get string from stream 从fp指向的文件中读取下一个输入行（包括换行符），并将它存放在字符数组中，最多可以读取maxline-1个字符，读取的行以’\0’结尾，不安全 5 gets char * gets ( char * str ); Get string from stdin 读取字符串，欲换行符’\n’结束，并删除换行符，用fgets代替 6 fputc int fputc ( int character, FILE * stream ); Write character to stream 成功，返回写入的字符，失败，返回EOF 7 putc int putc ( int character, FILE * stream ); 同上 putc and fputc are equivalent, except that putc may be implemented as a macro in some libraries 8 putchar int putchar ( int character ); Write character to stdout 同上 9 fputs int fputs ( const char * str, FILE * stream ); Write string to stream 成功，返回非负数，失败，返回EOF 10 puts int puts ( const char * str ); Write string to stdout(每行末尾自动添加换行符） 同上 11 ungetc int ungetc ( int character, FILE * stream ); 使字符c(转化为uchar型）被压入到指定输入流 成功，返回压入的字符，失败，返回EOF

3.5 Direct input/output:

序号 标签 函数原语 描述 补充描述 1 fread size_t fread ( void * ptr, size_t size, size_t count, FILE * stream ); Read block of data from stream 成功，返回读取的元素总数，失败，返回0（可以用feof或ferror工具判断是出现错误还是到文件末尾） 2 fwrite size_t fwrite ( const void * ptr, size_t size, size_t count, FILE * stream ); Write block of data to stream 返回实际写入元素的个数，正常情况返回值等于count

3.6 File positioning:

序号 标签 函数原语 描述 补充描述 1 fgetpos int fgetpos ( FILE * stream, fpos_t * pos ); Get current position in stream 成功，返回0 ，否则返回非零 2 fsetpos int fsetpos ( FILE * stream, const fpos_t * pos ); 根据*pos中的位置设置当前文件的位置 同上 3 fseek int fseek ( FILE * stream, long int offset, int origin ); 重定位文件位置以便随机stream流 同上 4 ftell long int ftell ( FILE * stream ); 返回当前流中的位置（同fgetpos) 但其返回long int（小型文件），大型文件用fgetpos 5 rewind void rewind ( FILE * stream ); 把流重置为起始位置 相当于 fseek(stream,0L,SEEK_SET)

3.7 Error-handling:

序号 标签 函数原语 描述 补充描述 1 clearerr void clearerr ( FILE * stream ); Resets both the error and the eof indicators of the stream 2 feof int feof ( FILE * stream ); 检测是否到达文件尾 到达结尾，返回非零，否则返回0 3 ferror int ferror ( FILE * stream ); 返回流的错误状态 若错误标志被设置，返回非零，否则返回0 4 perror void perror ( const char * str ); 打印错误信息至stderr

参考：http://www.cplusplus.com/reference/cstdio/
《C标准库》，P.J. Plauger 著
《C语言参考手册》，Samuel P. Harbison III 等著