流 I/O

这些函数处理不同大小和格式的数据,从单个字符到大型数据结构都有。 它们还提供缓冲区,这样能提高性能。 流缓冲区的默认大小为 4K。 这些例程会仅影响由运行时库例程创建的缓冲区,对由操作系统创建的缓冲区不起作用。

流 I/O 例程

例程 使用
clearerrclearerr_s 清除流的错误指示器
fclose 关闭流
_fcloseall 关闭所有打开的流,除了 stdinstdoutstderr
_fdopenwfdopen 将流与打开的文件的文件描述符相关联
feof 在流上测试文件尾
ferror 在流上测试错误
fflush 刷新到缓冲区或存储设备的流
fgetcfgetwc 从流( getcgetwc的函数版本)读取字符
_fgetchar_fgetwchar stdingetchargetwchar的函数版本)读取字符
fgetpos 获取流的位置指示器
fgetsfgetws 从流读取字符串
_fileno 获取与流关联的文件描述符
_flushall 刷新所有到缓冲区或存储设备的流
fopen_wfopenfopen_s_wfopen_s 打开流
fprintf_fprintf_lfwprintf_fwprintf_lfprintf_s_fprintf_s_lfwprintf_s_fwprintf_s_l 将格式化数据写入流
fputcfputwc 将字符写入流( putcputwc的函数版本)
_fputchar_fputwchar 将字符写入 stdoutputcharputwchar的函数版本)
fputsfputws 将字符串写入流
fread 从流中读取未格式化的数据
freopen_wfreopenfreopen_s_wfreopen_s 重新将 FILE 流指针分配到新的文件或设备
fscanffwscanffscanf_s_fscanf_s_lfwscanf_s_fwscanf_s_l 从流中读取格式化数据
fseek_fseeki64 将文件位置移动到给定位置
fsetpos 设置流的位置指示器
_fsopen_wfsopen 打开具有文件共享的流
ftell_ftelli64 获取当前文件位置
fwrite 将未格式化的数据项目写入流
getcgetwc 从流( fgetcfgetwc的宏版本)读取字符
getchargetwchar stdinfgetcharfgetwchar的宏版本)读取字符
_getmaxstdio 返回在 I/O 流级别允许同时打开的文件数。
gets_s_getws_s stdin 读取行
_getw 从流读取二进制 int
printf_printf_lwprintf_wprintf_lprintf_s_printf_s_lwprintf_s_wprintf_s_l 将格式化数据写入 stdout
putcputwc 将字符写入流( fputcfputwc的宏版本)
putcharputwchar 将字符写入 stdoutfputcharfputwchar的宏版本)
puts_putws 将行写入流
_putw 将二进制 int 写入流
rewind 将文件位置移动到的流的开头
_rmtmp 删除 tmpfile创建的临时文件
scanf_scanf_lwscanf_wscanf_lscanf_s_scanf_s_lwscanf_s_wscanf_s_l stdin 读取格式化数据
setbuf 控制流缓冲
_setmaxstdio 设置在流 I/O 级别同时打开的最大文件数。
setvbuf 控制流缓冲和缓冲区大小
_snprintf_snwprintf_snprintf_s_snprintf_s_l_snwprintf_s_snwprintf_s_l 将指定长度的格式化数据写入字符串
_snscanf_snwscanf_snscanf_s_snscanf_s_l_snwscanf_s_snwscanf_s_l 从标准输入流读取指定长度的格式化数据。
sprintfswprintfsprintf_s_sprintf_s_lswprintf_s_swprintf_s_l 将格式化数据写入字符串
sscanfswscanfsscanf_s、_sscanf_s_l、swscanf_s_swscanf_s_l 从字符串读取格式化数据
_tempnam_wtempnam 在给定目录中生成临时文件名
tmpfiletmpfile_s 创建临时文件
tmpnam_wtmpnamtmpnam_s_wtmpnam_s 生成临时文件名
ungetcungetwc 将字符推送回流上
_vcprintf_vcwprintf_vcprintf_s_vcprintf_s_l_vcwprintf_s_vcwprintf_s_l 将格式化数据写入控制台。
vfprintfvfwprintfvfprintf_s_vfprintf_s_lvfwprintf_s_vfwprintf_s_l 将格式化数据写入流
vprintfvwprintfvprintf_s_vprintf_s_lvwprintf_s_vwprintf_s_l 将格式化数据写入 stdout
_vsnprintf_vsnwprintfvsnprintf_s_vsnprintf_s_vsnprintf_s_l_vsnwprintf_s_vsnwprintf_s_l 将指定长度的格式化数据写入缓冲区
vsprintfvswprintfvsprintf_s_vsprintf_s_lvswprintf_s_vswprintf_s_l 将格式化数据写入缓冲区

当程序开始执行时,启动代码将自动开启若干流:标准输入(由 stdin指向)、标准输出(由 stdout指向)和标准错误(由 stderr指向)。 默认情况下,这些流将定向到控制台(键盘和屏幕)。 使用 freopenstdinstdoutstderr 重定向到磁盘文件或设备。

默认情况下,会对使用流例程打开的文件执行缓冲操作。 当 stdoutstderr 函数是完整的,或在进行了每次库调用之后要写入字符设备时,这两个函数将被刷新。 如果某个程序异常终止,则可能不会刷新输出缓冲区,从而导致数据丢失。 使用 fflush_flushall 来确保将与指定文件关联的缓冲区刷新到操作系统,或刷新所有打开的缓冲区。 操作系统可以在将数据写入磁盘之前缓存数据。 提交到磁盘功能可确保刷新的缓冲区内容不会丢失(如果系统发生故障)。

有两种方法将缓冲区内容提交到磁盘:

  • 与文件 COMMODE.OBJ 链接以设置全局提交标志。 全局标志的默认设置是 n,意味着“不提交”。

  • cfopen 将模式标志设置为 _fdopen

专门使用 cn 标志打开的任何文件的行为以该标志为准,而不考虑全局提交/不提交标志的状态。

如果程序未显式关闭流,则当程序终止时,该流会自动关闭。 但是,你应在程序完成流操作时关闭流,因为可以同时打开的流的数量是有限。 有关此限制的详细信息,请参阅 _setmaxstdio

只有通过对 fflush 或对文件定位函数(fseekfsetposrewind)进行干预调用时,输入才能直接跟随输出。 如果输入操作遇到文件的末尾,则输入可以后跟输出,而无需对文件定位函数进行干预调用。

另请参阅

输入和输出
按类别分的通用 C 运行时例程