C函数库stdio.h概况
库变量
size_t 这是无符号整数类型,它是 sizeof 关键字的结果。
FILE 这是一个适合存储文件流信息的对象类型。
fpos_t 这是一个适合存储文件中任何位置的对象类型。
库宏
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 the fseek 函数中使用,用于在一个文件中定位不同的位置。
TMP_MAX 这个宏是 tmpnam 函数可生成的独特文件名的最大数量。
stderr、stdin 和 stdout 这些宏是指向 FILE 类型的指针,分别对应于标准错误、标准输入和标准输出流。
库函数
函数名称: fclose
函数原型: int fclose(FILE* stream);
函数功能: 关闭流 stream。刷新所有的缓冲区。
函数返回: 关闭成功返回非0 ,否则返回 0.
函数名称: cleareer
函数原型: int cleareer(FILE* stream);
函数功能: 清除给定流 stream 的文件结束和错误标识符。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: feof
函数原型: int feof(FILE* stream);
函数功能: 测试给定流 stream 的文件结束标识符。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: ferror
函数原型: int ferror(FILE* stream);
函数功能: 测试给定流 stream 的错误标识符。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: fflush
函数原型: int fflush(FILE* stream);
函数功能: 刷新流 stream 的输出缓冲区。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: fgetpos
函数原型: int fgetpos(FILE* stream, fpos_t* pos);
函数功能: 获取流 stream 的当前文件位置,并把它写入到 pos。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: fopen
函数原型: FILE *fpoen(const char* filename, const char* mode);
函数功能: 使用给定的模式 mode 打开 filename 所指向的文件。
函数返回: 返回FILE
函数名称: fread
函数原型: size_t fread(void *ptr, size_t size, size_t nmemb, FILE *stream)
函数功能: 从给定流 stream 读取数据到 ptr 所指向的数组中。
函数返回: 返回size_t
函数名称: freopen
函数原型: FILE *freopen(const char *filename, const char *mode, FILE *stream)
函数功能: 把一个新的文件名 filename 与给定的打开的流 stream 关联,同时关闭流中的旧文件。
函数返回: 返回FILE
函数名称: fseek
函数原型: int fseek(FILE *stream, long int offset, int whence)
函数功能: 设置流 stream 的文件位置为给定的偏移 offset,参数 offset 意味着从给定的 whence 位置查找的字节数。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: fsetpos
函数原型: int fsetpos(FILE *stream, const fpos_t *pos)
函数功能: 设置给定流 stream 的文件位置为给定的位置。参数 pos 是由函数 fgetpos 给定的位置。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: ftell
函数原型: long int ftell(FILE *stream)
函数功能: 返回给定流 stream 的当前文件位置。
函数返回: 给定流 stream 的当前文件位置。
函数名称: fwrite
函数原型:size_t fwrite(const void *ptr, size_t size, size_t nmemb, FILE *stream)
函数功能: 把 ptr 所指向的数组中的数据写入到给定流 stream 中。
函数返回: 返回size_t
函数名称: remove
函数原型: int remove(const char *filename)
函数功能: 删除给定的文件名 filename,以便它不再被访问。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: rename
函数原型: int rename(const char *old_filename, const char *new_filename)
函数功能: 把 old_filename 所指向的文件名改为 new_filename。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: rewind
函数原型: void rewind(FILE *stream)
函数功能: 设置文件位置为给定流 stream 的文件的开头。
函数返回:
函数名称: setbuf
函数原型: void setbuf(FILE *stream, char *buffer)
函数功能: 定义流 stream 应如何缓冲。
函数返回:
函数名称: setvbuf
函数原型: int setvbuf(FILE *stream, char *buffer, int mode, size_t size)
函数功能: 另一个定义流 stream 应如何缓冲的函数。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: tmpfile
函数原型: FILE *tmpfile(void)
函数功能: 以二进制更新模式(wb+)创建临时文件。
函数返回: 返回FILE
函数名称: tmpnam
函数原型: char *tmpnam(char *str)
函数功能: 生成并返回一个有效的临时文件名,该文件名之前是不存在的。
函数返回: 返回文件名
函数名称: fprintf
函数原型: int fprintf(FILE *stream, const char *format, ...)
函数功能: 发送格式化输出到流 stream 中。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: printf
函数原型: int printf(const char *format, ...)
函数功能: 发送格式化输出到标准输出 stdout。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: sprintf
函数原型: int sprintf(char *str, const char *format, ...)
函数功能: 发送格式化输出到字符串。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: vfprintf
函数原型: int vfprintf(FILE *stream, const char *format, va_list arg)
函数功能: 使用参数列表发送格式化输出到流 stream 中。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: vprintf
函数原型: int vfprintf(const char *format, va_list arg)
函数功能: 使用参数列表发送格式化输出到标准输出 stdout。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: vsprintf
函数原型: int vsprintf(char *str, const char *format, va_list arg)
函数功能: 使用参数列表发送格式化输出到字符串。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: fscanf
函数原型: int fscanf(FILE *stream, const char *format, ...)
函数功能: 从流 stream 读取格式化输入。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: scanf
函数原型: int scanf(const char *format, ...)
函数功能: 从标准输入 stdin 读取格式化输入。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: sscanf
函数原型: int sscanf(const char *str, const char *format, ...)
函数功能: 从字符串读取格式化输入。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: fgetc
函数原型: int fgetc(FILE *stream)
函数功能: 从指定的流 stream 获取下一个字符(一个无符号字符),并把位置标识符往前移动。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: fgets
函数原型: char *fgets(char *str, int n, FILE *stream)
函数功能: 从指定的流 stream 读取一行,并把它存储在 str 所指向的字符串内。当读取 (n-1) 个字符时,或者读取到换行符时,或者到达文件末尾时,它会停止,具体视情况而定。
函数返回: 成功返回字符串
函数名称: fputc
函数原型: int fputc(int char, FILE *stream)
函数功能: 把参数 char 指定的字符(一个无符号字符)写入到指定的流 stream 中,并把位置标识符往前移动。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: fputs
函数原型: int fputs(const char *str, FILE *stream)
函数功能: 把字符串写入到指定的流 stream 中,但不包括空字符。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: getc
函数原型: int getc(FILE *stream)
函数功能: 从指定的流 stream 获取下一个字符(一个无符号字符),并把位置标识符往前移动。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: getchar
函数原型: int getchar(void)
函数功能: 从标准输入 stdin 获取一个字符(一个无符号字符)。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: gets
函数原型: char *gets(char *str)
函数功能: 从标准输入 stdin 读取一行,并把它存储在 str 所指向的字符串中。当读取到换行符时,或者到达文件末尾时,它会停止,具体视情况而定。
函数返回: 成功返回字符串
函数名称: putc
函数原型: int putc(int char, FILE *stream)
函数功能: 把参数 char 指定的字符(一个无符号字符)写入到指定的流 stream 中,并把位置标识符往前移动。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: putchar
函数原型: int putchar(int char)
函数功能: 把参数 char 指定的字符(一个无符号字符)写入到标准输出 stdout 中。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: puts
函数原型: int puts(const char *str)
函数功能: 把一个字符串写入到标准输出 stdout,直到空字符,但不包括空字符。换行符会被追加到输出中。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: ungetc
函数原型: int ungetc(int char, FILE *stream)
函数功能: 把字符 char(一个无符号字符)推入到指定的流 stream 中,以便它是下一个被读取到的字符。
函数返回: 成功返回非0 ,否则返回 0.
函数名称: perror
函数原型: void perror(const char *str)
函数功能: 把一个描述性错误消息输出到标准错误 stderr。首先输出字符串 str,后跟一个冒号,然后是一个空格。
函数返回: