fopen_s函数

#define __STDC_WANT_LIB_EXT1__ 1
#include <stdio.h>
errno_t fopen_s(FILE * restrict * restrict streamptr,
      const char * restrict filename,
      const char * restrict mode);

该函数以参数mode指定的模式打开参数filename指定的文件，并将其与流进行关联。

文件打开时，当且仅当不引用交互式设备的情况下，流是完全缓冲的；流的错误指示符和文件末尾指示符会被清除。

如果成功打开文件，参数streamptr指向的FILE类型指针将被设置为控制打开文件的对象指针；如果不成功，参数streamptr指向的FILE类型指针将被设置为空指针。

调用fclose、freopen_s函数以及程序正常终止时，会解除流与文件的关联。

宏FOPEN_MAX表示实现可以保证的同时打开的最少文件数；ISO/IEC 9899:2018标准规定：宏FOPEN_MAX应至少为8(包括3个标准文本流stdin、stdout、stderr。)。同一文件能否同时多次打开将由实现定义。

参数streamptr、filename、mode不能是空指针。

如果存在运行约束冲突，函数fopen_s不会尝试打开文件；此外如果参数streamptr不是空指针，函数将*streamptr设置为空指针。

指向FILE类型指针的指针。

char类型指针，指向表示文件名的字符串(如果系统支持，文件名可以包含路径。)，文件名规则由实现定义。

char类型指针，指向的字符串表示文件访问模式。ISO/IEC 9899:2018标准支持的文件访问模式具体如下所示：

如果模式参数是除上表以外的其它值，函数行为是未定义的。

函数fopen_s和函数fopen的模式字符串基本一致，区别在于以'w'或者'a'开始的模式前可以存在'u'。

如果文件不存在或者文件无法读取，以读取模式（打开模式中存在r字符。）打开文件将会失败。

如果文件已经存在或者无法创建，以独占模式（打开模式中存在x字符。）打开文件将会失败。

底层系统可能在一定程度上支持独占访问权限，即进行写操作的文件以独占（非共享）的访问方式打开。创建文件时，如果模式字符串的第一个字符不是'u'，文件应具有防止系统中的其它用户访问该文件的权限；如果模式字符串的第一个字符是'u'，到文件关闭时该文件具有系统默认的文件访问权限，该权限与使用fopen函数创建的文件权限相同。

以添加模式打开文件（打开模式中存在a字符。）会导致对文件的所有后续写入都被强制到文件的当前末尾，而不管fseek函数的调用。由于空字符填充，在一些实现中以添加模式打开二进制文件（打开模式中存在b字符。）可能最初将流的文件位置指示符定位在最后写入的数据之外。

当以更新模式（打开模式中存在+字符。）打开文件时，可以在关联的流上执行输入和输出操作。在没有调用fflush函数或者文件定位函数（例如：fseek、fsetpos、rewind函数。）的情况下，输出操作后不能立即执行输入操作；在没有调用文件定位函数的情况下，输入操作后不能立即执行输出操作，除非输入操作到达文件末尾（end-of-file）。在某些实现中，使用更新模式打开或者创建文本文件可能会打开或者创建二进制流。

如果成功打开文件，函数返回0；如果不能打开文件或者存在运行约束冲突，函数返回非0值。

1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 

/*安全函数fopen_s范例*/

#define __STDC_WANT_LIB_EXT1__ 1
#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    FILE *pFile;
    
    /*创建文件。*/
    if(fopen_s(&pFile, "gchFile.txt", "w"))
        exit(EXIT_FAILURE);
    else
        fputs("Practice makes perfect.", pFile);
    
    /*关闭文件。*/
    fclose(pFile);

    return 0;
}

在和该C程序相同的目录下，创建了一个名为gchFile.txt、内容为Practice makes perfect.的文件。

注：使用Visual Studio编译。