# C 标准库 - <stdio.h> ## 简介 **stdio .h** 头文件定义了三个变量类型、一些宏和各种函数来执行输入和输出。 ## 库变量 下面是头文件 stdio.h 中定义的变量类型： | 变量 | 描述 | | --- | --- | | **size_t** | 这是无符号整数类型，它是 **sizeof** 关键字的结果。 | | **FILE** | 这是一个适合存储文件流信息的对象类型。 | | **fpos_t** | 这是一个适合存储文件中任何位置的对象类型。 | ## 库宏 下面是头文件 stdio.h 中定义的宏： | 宏 | 描述 | | --- | --- | | **NULL** | 这个宏是一个空指针常量的值。 | | **_IOFBF、_IOLBF** 和 **_IONBF** | 这些宏扩展了带有特定值的整型常量表达式，并适用于 **setvbuf** 函数的第三个参数。 | | **BUFSIZ** | 这个宏是一个整数，该整数代表了 **setbuf** 函数使用的缓冲区大小。 | | **EOFM** | 这个宏是一个表示已经到达文件结束的负整数。 | | **FOPEN_MAX** | 这个宏是一个整数，该整数代表了系统可以同时打开的文件数量。 | | **FILENAME_MAX** | 这个宏是一个整数，该整数代表了字符数组可以存储的文件名的最大长度。如果实现没有任何限制，则该值应为推荐的最大值。 | | **L_tmpnam** | 这个宏是一个整数，该整数代表了字符数组可以存储的由 tmpnam 函数创建的临时文件名的最大长度。 | | **SEEK_CUR、SEEK_END** 和 **SEEK_SET** | 这些宏是在These macros are used in the **fseek** 函数中使用，用于在一个文件中定位不同的位置。 | | **TMP_MAX** | 这个宏是 tmpnam 函数可生成的独特文件名的最大数量。 | | **stderr、stdin** 和 **stdout** | 这些宏是指向 FILE 类型的指针，分别对应于标准错误、标准输入和标准输出流。 | ## 库函数 下面是头文件 stdio.h 中定义的函数： > 为了更好地理解函数，请按照下面的序列学习这些函数，因为第一个函数中创建的文件会在后续的函数中使用到。 | 函数 | 描述 | | --- | --- | | [int fclose(FILE \*stream)](c-function-fclose.html) | 关闭流 stream。刷新所有的缓冲区。 | | [void clearerr(FILE \*stream)](c-function-clearerr.html) | 清除给定流 stream 的文件结束和错误标识符。 | | [int feof(FILE \*stream)](c-function-feof.html) | 测试给定流 stream 的文件结束标识符。 | | [int ferror(FILE \*stream)](c-function-ferror.html) | 测试给定流 stream 的错误标识符。 | | [int fflush(FILE \*stream)](c-function-fflush.html) | 刷新流 stream 的输出缓冲区。 | | [int fgetpos(FILE \*stream, fpos_t \*pos)](c-function-fgetpos.html) | 获取流 stream 的当前文件位置，并把它写入到 pos。 | | [FILE \*fopen(const char \*filename, const char \*mode)](c-function-fopen.html) | 使用给定的模式 mode 打开 filename 所指向的文件。 | | [size_t fread(void \*ptr, size_t size, size_t nmemb, FILE \*stream)](c-function-fread.html) | 从给定流 stream 读取数据到 ptr 所指向的数组中。 | | [FILE \*freopen(const char \*filename, const char \*mode, FILE \*stream)](c-function-freopen.html) | 把一个新的文件名 filename 与给定的打开的流 stream 关联，同时关闭流中的旧文件。 | | [int fseek(FILE \*stream, long int offset, int whence)](c-function-fseek.html) | 设置流 stream 的文件位置为给定的偏移 offset，参数 _offset_ 意味着从给定的 _whence_ 位置查找的字节数。 | | [int fsetpos(FILE \*stream, const fpos_t \*pos)](c-function-fsetpos.html) | 设置给定流 stream 的文件位置为给定的位置。参数 _pos_ 是由函数 fgetpos 给定的位置。 | | [long int ftell(FILE \*stream)](c-function-ftell.html) | 返回给定流 stream 的当前文件位置。 | | [size_t fwrite(const void \*ptr, size_t size, size_t nmemb, FILE \*stream)](c-function-fwrite.html) | 把 ptr 所指向的数组中的数据写入到给定流 stream 中。 | | [int remove(const char \*filename)](c-function-remove.html) | 删除给定的文件名 filename，以便它不再被访问。 | | [int rename(const char \*old_filename, const char \*new_filename)](c-function-rename.html) | 把 old_filename 所指向的文件名改为 new_filename。 | | [void rewind(FILE \*stream)](c-function-rewind.html) | 设置文件位置为给定流 stream 的文件的开头。 | | [void setbuf(FILE \*stream, char \*buffer)](c-function-setbuf.html) | 定义流 stream 应如何缓冲。 | | [int setvbuf(FILE \*stream, char \*buffer, int mode, size_t size)](c-function-setvbuf.html) | 另一个定义流 stream 应如何缓冲的函数。 | | [FILE \*tmpfile(void)](c-function-tmpfile.html) | 以二进制更新模式(wb+)创建临时文件。 | | [char \*tmpnam(char \*str)](c-function-tmpnam.html) | 生成并返回一个有效的临时文件名，该文件名之前是不存在的。 | | [int fprintf(FILE \*stream, const char \*format, ...)](c-function-fprintf.html) | 发送格式化输出到流 stream 中。 | | [int printf(const char \*format, ...)](c-function-printf.html) | 发送格式化输出到标准输出 stdout。 | | [int sprintf(char \*str, const char \*format, ...)](c-function-sprintf.html) | 发送格式化输出到字符串。 | | [int vfprintf(FILE \*stream, const char \*format, va_list arg)](c-function-vfprintf.html) | 使用参数列表发送格式化输出到流 stream 中。 | | [int vprintf(const char \*format, va_list arg)](c-function-vprintf.html) | 使用参数列表发送格式化输出到标准输出 stdout。 | | [int vsprintf(char \*str, const char \*format, va_list arg)](c-function-vsprintf.html) | 使用参数列表发送格式化输出到字符串。 | | [int fscanf(FILE \*stream, const char \*format, ...)](c-function-fscanf.html) | 从流 stream 读取格式化输入。 | | [int scanf(const char \*format, ...)](c-function-scanf.html) | 从标准输入 stdin 读取格式化输入。 | | [int sscanf(const char \*str, const char \*format, ...)](c-function-sscanf.html) | 从字符串读取格式化输入。 | | [int fgetc(FILE \*stream)](c-function-fgetc.html) | 从指定的流 stream 获取下一个字符（一个无符号字符），并把位置标识符往前移动。 | | [char \*fgets(char \*str, int n, FILE \*stream)](c-function-fgets.html) | 从指定的流 stream 读取一行，并把它存储在 str 所指向的字符串内。当读取 \*\*(n-1)\*\* 个字符时，或者读取到换行符时，或者到达文件末尾时，它会停止，具体视情况而定。 | | [int fputc(int char, FILE \*stream)](c-function-fputc.html) | 把参数 char 指定的字符（一个无符号字符）写入到指定的流 stream 中，并把位置标识符往前移动。 | | [int fputs(const char \*str, FILE \*stream)](c-function-fputs.html) | 把字符串写入到指定的流 stream 中，但不包括空字符。 | | [int getc(FILE \*stream)](c-function-getc.html) | 从指定的流 stream 获取下一个字符（一个无符号字符），并把位置标识符往前移动。 | | [int getchar(void)](c-function-getchar.html) | 从标准输入 stdin 获取一个字符（一个无符号字符）。 | | [char \*gets(char \*str)](c-function-gets.html) | 从标准输入 stdin 读取一行，并把它存储在 str 所指向的字符串中。当读取到换行符时，或者到达文件末尾时，它会停止，具体视情况而定。 | | [int putc(int char, FILE \*stream)](c-function-putc.html) | 把参数 char 指定的字符（一个无符号字符）写入到指定的流 stream 中，并把位置标识符往前移动。 | | [int putchar(int char)](c-function-putchar.html) | 把参数 char 指定的字符（一个无符号字符）写入到标准输出 stdout 中。 | | [int puts(const char \*str)](c-function-puts.html) | 把一个字符串写入到标准输出 stdout，直到空字符，但不包括空字符。换行符会被追加到输出中。 | | [int ungetc(int char, FILE \*stream)](c-function-ungetc.html) | 把字符 char（一个无符号字符）推入到指定的流 stream 中，以便它是下一个被读取到的字符。 | | [void perror(const char \*str)](c-function-perror.html) | 把一个描述性错误消息输出到标准错误 stderr。首先输出字符串 str，后跟一个冒号，然后是一个空格。 |