fopen, fopen_s
定义于头文件 <stdio.h>
|
||
(1) | ||
FILE *fopen( const char *filename, const char *mode ); |
(C99 前) | |
FILE *fopen( const char *restrict filename, const char *restrict mode ); |
(C99 起) | |
errno_t fopen_s(FILE *restrict *restrict streamptr, const char *restrict filename, |
(2) | (C11 起) |
1) 打开
filename
所指示的文件,并返回指向关联到该文件的文件流的指针。 mode
用于确定文件访问模式。2) 同(1),除了指向文件流的指针被写入
streamptr
,还在运行时检测下列错误,并调用当前安装的制约处理函数:
-
streamptr
是空指针 -
filename
是空指针 -
mode
是空指针
-
- 同所有边界检查函数,
fopen_s
仅若实现定义了 __STDC_LIB_EXT1__ ,且用户在包含<stdio.h>
前定义 __STDC_WANT_LIB_EXT1__ 为整数常量 1 才保证可用。
参数
filename | - | 关联到文件系统的文件名 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
mode | - | 确定访问模式的空终止字符串
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||
streamptr | - | 指向存储函数结果的指针的指针(输出参数) |
返回值
2) 若成功,则返回零并将新文件流指针写入
*streamptr
。错误时,返回非零错误码并将空指针写入 *streamptr
(除非 streamptr
自身也是空指针)。注意
filename
的格式是实现定义的,而且不需要表示一个文件(譬如可以是控制台或另一能通过文件系统 API 访问的设备)。在支持的平台上, filename
可以包含绝对或相对路径。
示例
运行此代码
#include <stdio.h> #include <stdlib.h> int main(void) { FILE* fp = fopen("test.txt", "r"); if(!fp) { perror("File opening failed"); return EXIT_FAILURE; } int c; // 注意:int,非char,要求处理EOF while ((c = fgetc(fp)) != EOF) { // 标准C I/O读取文件循环 putchar(c); } if (ferror(fp)) puts("I/O error when reading"); else if (feof(fp)) puts("End of file reached successfully"); fclose(fp); }
引用
- C11 standard (ISO/IEC 9899:2011):
- 7.21.5.3 The fopen function (p: 305-306)
- K.3.5.2.1 The fopen_s function (p: 588-590)
- C99 standard (ISO/IEC 9899:1999):
- 7.19.5.3 The fopen function (p: 271-272)
- C89/C90 standard (ISO/IEC 9899:1990):
- 4.9.5.3 The fopen function
参阅
关闭文件 (函数) | |
将输出流与实际文件同步 (函数) | |
(C11) |
以不同名称打开既存的文件流 (函数) |