头文件(stdio.h)
执行输入/输出操作的C++库
输入与输出操作在C++中也可以通过使用C标准输入输出库(cstdio,在C语言中为stdio.h)实现。该库使用所谓的“流“操作物理设备,如键盘、打印机、终端或系统支持的其它类型文件。流是与这些物理设备以统一方式交互的抽象概念。所有的流都具有独立于它们相关联的物理设备个体特性的相似属性。
流在cstdio库中以指向FILE对象的指向方式操作。一个指向FILE对象的指针唯一表示一个流,并且在设计该流的操作中作为参数使用。
存在三种标准流:stdin、stdout与stderr,它们自动为所有使用该库的程序公开创建。
流属性
流拥有一些属性,定义了哪些函数可以作用于它们与如何对待从它们输入或输出的数据。这些属性的绝大多数在通过fopen函数将该流与文件关联(opened)的时刻就已经定义了:
读/写访问
指定该流是否具有它们关联的物理媒体的读或写访问权限(或两者都有)。
文本/二进制
文本流被认为是表示一些列文本行,每一行以换行符结束。根据程序运行环境的不同,为了使一些特殊字符适应文本文件环境的特殊性,一些字符转换也许会发生。另一方面,二进制流是不经过任何转换写入物理媒介或从物理媒介读出的一系列字符,它们与从流中读出或写入流的字符一一对应。
缓存
混村是一个内存块,数据在从关联的文件或设备中读入或写入之前累计的地方。流可以是全缓存、行缓存或不缓存。对于全缓存流,数据当该流满了时读取/写入,对于行缓存流,发生在遇到换行符时,对于不缓存流字符立即被读取/写入。
定向
在打开时,流是没有定向的。当输入/输出操作作用在它们身上时,它们变成面向字节的或面向宽字节的,这取决于作用的操作符(通常定义在中的函数是面向字节的,然而定义在中的函数是面向宽字节的)。了解更多,查看cwchar。
指示器
流用于特定的内部指示器,它们表名它们的当前状态与哪些影响作用于它们身上的输入输出操作的行为:
错误指示符
该指示符当错误发生在相对于流的操作时设置。该指示器可以通过ferror函数检测,并且可以通过调用clearerr、freopen或rewind重设。
文件结束指示符
一旦设定,表明作用于该流上的下一个读或写操作到达文件结尾。它可以通过feof函数检测,并且可以通过调用clearerr、freopen或调用任何重定位函数(rewind,fseek与fsetpos)重设。
定位指示符
它是每个流的一个内部指针,它指向读或写向下一个I/O操作的下一个字符。它的值可以通过ftell或fgetpos函数获取,并且可以通过使用重定位函数rewind、fseek与fsetpos函数改变。
函数
操作文件:
remove删除文件(函数)rename重命名文件(函数)tmpfile打开一个临时文件(函数)tmpnam产生一个临时文件名(函数)
文件访问:
fclose关闭文件(函数)fflush冲刷流(函数)fopen打开文件(函数)freopen用不同的文件或模式重新打开流(函数)setbuf设置流缓存(函数)servbuf改变流缓存(函数)
格式化输入/输出:
fprintf将格式化数据写入流(函数)fscanf从流中读格式化数据(函数)printf打印格式化数据到stdout(函数)scanf从stdin中读格式化数据(函数)snprintf将格式化数据写入定长缓存(函数)sprintf写格式化数据到字符串(函数)sscanf从字符串中读格式化数据(函数)vfprintf将格式化数据从变参列表写入流(函数)vfscanf从流中读取格式化数据到变参列表(函数)vprintf打印变参列表中的格式化数据到stdout(函数)vscanf读取格式化数据到变参列表(函数)vsnprintf将变参列表中的格式化数据写入定长缓存(函数)vsprintf将变参列表中的格式化数据写入字符串(函数)vsscanf从字符串读取格式化数据到变参列表(函数)
字符串输入/输出:
fgetc从流中获取字符(函数)fgets从流中获取字符串(函数)fputc将字符写入流(函数)fputs将字符串写入流(函数)getc从流中获取字符(函数)getchar从stdin中获取字符(函数)gets从stdin中获取字符串(函数)putc将字符写入流(函数)putchar将字符写入stdout(函数)puts将字符串写入stdout(函数)ungetc不从流中获取字符(函数)
直接输入/输出:
fread从流中读取数据块(函数)fwrite将数据块写入流(函数)
文件定位:
fgetpos从流中获取当前位置(函数)fseek重新定位流位置指示器(函数)fsetpos设置流位置指示器(函数)ftell获取流当前位置(函数)rewind设置流位置为开始处(函数)
错误处理:
clearerr清除错误指示器(函数)feof检查文件结束指示器(函数)ferror检查错误指示器(函数)perror打印错误信息(函数)
宏
BUFSIZE缓冲大小(常量)EOF文件结束(常量)FILENAME_MAX文件名的最大长度(常量)FOPEN_MAX连续打开流的潜在限制(常量)L_tmpnam临时文件名的最小长度(常量)NULLnull指针(宏)TMP_MAX临时文件数量(常量) 此外:_IOFBF、_IOLBF、_IONBF(用在setvbuf)
SEEK_CUR、SEEK_END与SEEK_SET(用在fseek)。
类型
FILE包含控制流的信息的对象(类型)fpos_t包含在文件中指定位置的信息的对象(类型)size_t无符号整数类型(类型)
英文原版:/reference/cstdio/