FILE *
进行的,称其为文件指针
。FILE对象通常是一个结构,它包括了标准I/O库为管理该流需要的所有信息,包括用于实际I/O的文件描述符、指向用于该流缓冲区的指针、缓冲区的长度、当前在缓冲区中的字符数以及出错标志等。
标准I/O文件流可用于单字节或多字节(“宽”)字符集。
宽定向
的;若在为定向的流上使用一个单字节I/O函数,则将流的定向设置为字节定向
的。#include <stdio.h>
#include <wchar.h>
int fwide(FILE *fp, int mode);
Returns: positive if stream is wide oriented,
negative if stream is byte oriented,
or 0 if stream has no orientation
- mode为负,则字节定向;
- mode为正,则宽定向;
- mode为0,则不设置流的定向,fwide返回标识该流定向的值
标准I/O库提供缓冲的目的是尽可能减少使用read和write调用的次数。它对每个I/O流自动地进行缓冲管理,从而避免了应用程序需要考虑这一点所带来的麻烦。遗憾的是,标准I/O库最令人迷惑的也是它的缓冲。
标准I/O提供了以下3种类型的缓冲:
- 全缓冲。在填满标准I/O缓冲区后才进行实际I/O操作。对于驻留在磁盘上的文件通常由标准I/O库实施全缓冲。缓冲区可由标准I/O例程自动地冲洗(flush),也可通过调用函数fflush冲洗一个流。
- 术语flush有两种意思:在标准I/O库方面,flush(冲洗)意味着缓冲区中的内容写到磁盘上;在终端驱动程序方面,flush(刷清)表示丢弃已存储在缓冲区中的数据。
- 行缓冲。当输入或输出中遇到换行符时,标准I/O库执行I/O操作。当流涉及一个终端时,通常使用行缓冲。
- 对于行缓冲有两个限制:
- 只要填满了缓冲区,即使还没遇到换行符,也进行I/O操作;
- 任何时候只要通过标准I/O库要求从(a)
一个
不带缓冲的流,或者(b)一个
行缓冲的流得到输入数据,那么就会flush所有
行缓冲输出流。- 不带缓冲。标准I/O库不对字符进行缓冲存储。如fputs函数。标准错误流stderr通常是不带缓冲的。
ISO C要求下列缓冲特征:
- 当且仅当标准输入和标准输出并不指向交互式设备时,它们才是全缓冲的
- 标准错误决不会是全缓冲的
很多系统默认使用下列类型的缓冲:
- 标准错误是不带缓冲的
- 若是指向终端设备的流,则是行缓冲的;否则是全缓冲的
#include <stdio.h>
void setbuf(FILE *restrict fp, char *restrict buf );
// 使用该函数打开或关闭缓冲机制。参数buf必须指向一个长度为BUFSIZ的缓冲区;或为NULL以关闭缓冲
int setvbuf(FILE *restrict fp, char *restrict buf, int mode, size_t size);
Returns: 0 if OK, nonzero on error
#include <stdio.h>
int fflush(FILE *fp); // 若fp为NULL,则导致所有输出流被冲洗
Returns: 0 if OK, EOF on error
#include <stdio.h>
FILE *fopen(const char *restrict pathname, const char *restrict type);
FILE *freopen(const char *restrict pathname, const char *restrict type, FILE *restrict fp);
// 在一个指定的流上打开一个指定的文件,如若该流已经打开,则先关闭该流
FILE *fdopen(int fd, const char *type); // 取一个已有的文件描述符,并使一个标准的I/O流与该描述符相结合
All three return: file pointer if OK, NULL on error
如果以读和写类型打开一个文件时(type中带+号),具有下列限制:
- 如果中间没有fflush、fseek、fsetpos或rewind,则在输出的后面不能直接跟随输入
- 如果中间没有fseek、fsetpos或rewind,或者一个输入操作没有到达文件尾端,则在输入操作之后不能直接跟随输出
打开一个标准I/O流的6种不同方式
#include <stdio.h>
int fclose(FILE *fp);
Returns: 0 if OK, EOF on error
一旦打开了流,可在3种
不同类型的非格式化I/O中进行选择,对其进行读、写操作
- 每次一个字符的I/O
- 每次一行的I/O
- 直接I/O(二进制I/O、面向记录的I/O、一次一个对象的I/O)
在大多数实现中,为每个流在FILE对象中维护了两个标志:
- 出错标志
- 文件结束标志
区分是出错还是到达文件尾端,因为这两种情况下返回值相同
#include <stdio.h>
int ferror(FILE *fp);
int feof(FILE *fp);
Both return: nonzero (true) if condition is true, 0 (false) otherwise
void clearerr(FILE *fp); // 调用clearerr可以清除这两个标志
#include <stdio.h>
int getc(FILE *fp); // 可被实现为宏,故参数不应当是具有副作用的表达式;返回值是int,因为常量EOF是-1
int fgetc(FILE *fp); // 一定是个函数
int getchar(void); // getc(stdin)
All three return: next character if OK, EOF on end of file or error
#include <stdio.h>
int ungetc(int c, FILE *fp); // 将字符再压送回流中,可回送多次,但再次读出字符的顺序与压送回的顺序相反。一次一字符
// 作用:有时需要查看下一个字符,以决定对当前字符如何处理
Returns: c if OK, EOF on error
#include <stdio.h>
int putc(int c, FILE *fp);
int fputc(int c, FILE *fp);
int putchar(int c);
All three return: c if OK, EOF on error
#include <stdio.h>
char *fgets(char *restrict buf, int n, FILE *restrict fp); // 存入换行符
char *gets(char *buf ); // 不推荐使用,可能造成缓冲区溢出;并不将换行符存入缓冲区中
Both return: buf if OK, NULL on end of file or error
#include <stdio.h>
int fputs(const char *restrict str, FILE *restrict fp); // 不一定换行
int puts(const char *str); // 必定输出一换行符
Both return: non-negative value if OK, EOF on error
#include <stdio.h>
size_t fread(void *restrict ptr, size_t size, size_t nobj, FILE *restrict fp);
size_t fwrite(const void *restrict ptr, size_t size, size_t nobj, FILE *restrict fp);
Both return: number of objects read or written
- 读或写一个二进制数组
- 读或写一个结构
- 在一个结构中,同一成语的偏移量可能随编译程序和系统的不同而不同。
- 用来存储多字节整数和浮点数的二进制格式在不同的系统结构间也可能不同。
- ftell和fseek函数。它们假定文件的位置可以存放在一个长整型中
- ftello和fseeko函数。使用
off_t
数据类型代替long- fgetpos和fsetpos函数。由ISO C引入的。使用一个抽象数据类型
fpos_t
记录文件的位置。需要移植到非Unix系统上运行的应用程序使用fgetpos和fsetpos
#include <stdio.h>
long ftell(FILE *fp);
Returns: current file position indicator if OK, −1L on error
int fseek(FILE *fp, long offset, int whence);
Returns: 0 if OK, −1 on error
void rewind(FILE *fp);
#include <stdio.h>
off_t ftello(FILE *fp);
Returns: current file position indicator if OK, (off_t)−1 on error
int fseeko(FILE *fp, off_t offset, int whence);
Returns: 0 if OK, −1 on error
#include <stdio.h>
int fgetpos(FILE *restrict fp, fpos_t *restrict pos);
int fsetpos(FILE *fp, const fpos_t *pos);
Both return: 0 if OK, nonzero on error
#include <stdio.h>
int printf(const char *restrict format, ...);
int fprintf(FILE *restrict fp, const char *restrict format, ...); // 写到指定的流
int dprintf(int fd, const char *restrict format, ...); // 写到指定的文件描述符
All three return: number of characters output if OK, negative value if output error
int sprintf(char *restrict buf, const char *restrict format, ...);
// 写到数组buf,末尾加null字节,但该字节不包括在返回值中;可能溢出,故不推荐使用它
Returns: number of characters stored in array if OK, negative value if encoding error
int snprintf(char *restrict buf, size_t n, const char *restrict format, ...); // 显式指定了缓冲区长度n
Returns: number of characters that would have been stored in array
#include <stdarg.h>
#include <stdio.h>
int vprintf(const char *restrict format, va_list arg);
int vfprintf(FILE *restrict fp, const char *restrict format, va_list arg);
int vdprintf(int fd, const char *restrict format, va_list arg);
All three return: number of characters output if OK, negative value if output error
int vsprintf(char *restrict buf, const char *restrict format, va_list arg);
Returns: number of characters stored in array if OK, negative value if encoding error
int vsnprintf(char *restrict buf, size_t n, const char *restrict format, va_list arg);
Returns: number of characters that would have been stored in array
#include <stdio.h>
int scanf(const char *restrict format, ...);
int fscanf(FILE *restrict fp, const char *restrict format, ...);
int sscanf(const char *restrict buf, const char *restrict format, ...);
All three return: number of input items assigned,
EOF if input error or end of file before any conversion
#include <stdio.h>
int fileno(FILE *fp);
Returns: the file descriptor associated with the stream
#include <stdio.h>
char *tmpnam(char *ptr);
Returns: pointer to unique pathname
FILE *tmpfile(void);
Returns: file pointer if OK, NULL on error
- 若ptr为NULL,则所产生的路径名存放在一个静态区中,指向该静态区的指针作为函数值返回。后续调用tmpnam函数会重写该静态区
- 若ptr不为NULL,则认为它应该是指向长度至少是L_tmpnam(stdio.h中定义)个字符的数组
#include <stdlib.h>
char *mkdtemp(char *template);
Returns: pointer to directory name if OK, NULL on error
int mkstemp(char *template);
Returns: file descriptor if OK, −1 on error
XXXXXX
的路径名。#include <stdio.h>
FILE *fmemopen(void *restrict buf, size_t size, const char *restrict type);
Returns: stream pointer if OK, NULL on error
#include <stdio.h>
FILE *open_memstream(char **bufp, size_t *sizep); // 创建的流是面向字节的
#include <wchar.h>
FILE *open_wmemstream(wchar_t **bufp, size_t *sizep); // 创建的流是面向宽字节的
Both return: stream pointer if OK, NULL on error
- 创建的流只能写文件
- 不能指定自己的缓冲区,当可以分别通过bufp和sizep参数访问缓冲区地址和大小
- 关闭流后需要自行释放缓冲区
- 对流添加字节会增加缓冲区大小