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