fopen、_wfopen临时

打开文件。 提供这些函数的更多安全版本;请参见 fopen_s、_wfopen_s

FILE *fopen( 
   const char *filename,
   const char *mode 
);
FILE *_wfopen( 
   const wchar_t *filename,
   const wchar_t *mode 
);
filename

文件名。

mode

启用的访问类型。

这些函数均返回指向打开文件的指针。 一个 null 指针值指示错误。 如果 filename 或 mode 为 NULL 或空字符串,这些函数将触发无效参数处理程序(如参数验证所述)。 如果允许执行继续,则这些函数返回 NULL 并将 errno 设置为 EINVAL

有关更多信息,请参见 errno、_doserrno、_sys_errlist 和 _sys_nerr

fopen 函数打开 filename 指定的文件。 _wfopen 是 fopen 的宽字符版本;_wfopen 的参数是宽字符串。 除此以外,_wfopen 和 fopen 的行为完全相同。 仅使用 _wfopen 不会影响在文件流中使用的编码字符集。

fopen 接受执行时在文件系统上有效的路径;fopen 还接受 UNC 路径和包含映射的网络驱动器的路径(前提是执行代码的系统在执行时能够访问共享或映射的驱动器)。 为 fopen 构造路径时,请确保驱动器、路径或网络共享在执行环境中可用。 可使用斜杠 (/) 或反斜杠 (\) 作为路径中的目录分隔符。

对文件执行任何进一步操作前,请始终检查返回值以确定指针是否为 NULL。 如果发生错误,系统将设置全局变量 errno,此变量可用于获取特定错误信息。 有关更多信息,请参见 errno、_doserrno、_sys_errlist 和 _sys_nerr

Unicode 支持

fopen 支持 Unicode 文件流。 若要打开 Unicode 文件,请将指定所需编码的 ccs 标志传递到 fopen,如下所示。

fopen(&fp, "newfile.txt", "rt+, ccs= encoding ");

允许使用的 encoding 值为 UNICODEUTF-8 和 UTF-16LE

如果文件已存在并已打开以进行读取或追加,字节顺序标记 (BOM)(如果文件中有)将确定编码。 BOM 编码优先于 ccs 标志指定的编码。 只有在没有 BOM 或文件是新文件时,才使用 ccs 编码。

说明 说明

BOM 检测仅适用于在 Unicode 模式下(即通过传递 ccs 标志)打开的文件。

下表汇总的模式用于传递到文件中的 fopen 和字节顺序标记的各种 ccs 标志。

基于 ccs 标志和 BOM 使用的编码

ccs 标志

无 BOM(或新文件)

BOM:UTF-8

BOM:UTF-16

UNICODE

UTF-16LE

UTF-8

UTF-16LE

UTF-8

UTF-8

UTF-8

UTF-16LE

UTF-16LE

UTF-16LE

UTF-8

UTF-16LE

在 Unicode 模式下打开以进行写入的文件将自动写入 BOM。

如果 mode 为“a, ccs=<encoding>”,fopen 将先尝试使用读取和写入访问权限打开文件。 如果成功,此函数将读取 BOM 以确定文件的编码;如果失败,此函数将使用文件的默认编码。 无论何种情况,fopen 随后均将通过只写访问权限打开文件。(这仅适用于 a 模式,不适用于 a+ 模式。)

一般文本例程映射

TCHAR.H 例程

未定义的 _UNICODE 和 _MBCS

已定义 _MBCS

已定义 _UNICODE

_tfopen

fopen

fopen

_wfopen

字符串 mode 指定为文件请求的访问类型,如下所示。

"r"

打开以便读取。 如果文件不存在或找不到,fopen 调用将失败。

"w"

打开用于写入的空文件。 如果给定文件存在,则其内容会被销毁。

"a"

在文件末尾打开以进行写入(追加),在新数据写入到文件之前不移除文件末尾 (EOF) 标记。 创建文件(如果文件不存在)。

"r+"

打开以便读取和写入。 文件必须存在。

"w+"

打开用于读取和写入的空文件。 如果文件存在,则其内容会被销毁。

"a+"

打开以进行读取和追加。 追加操作包括在新数据写入文件之前移除 EOF 标记。 写入完成后,EOF 标记不会还原。 创建文件(如果文件不存在)。

使用 "a" 访问类型或 "a+" 访问类型打开文件时,所有写入操作均将在文件末尾进行。 使用 fseek 或 rewind 可重新定位文件指针,但在执行任何写入操作前,文件指针将始终被移回文件末尾。 因此,无法覆盖现有数据。

在 EOF 标记追加到文件之前,"a" 模式不会将其移除。 在追加后,MS-DOS TYPE 命令只显示原始 EOF 标记之前的数据,不显示追加到文件的任何数据。 EOF 标记追加到文件之前,"a+" 模式不会将其移除。 在追加后,MS-DOS TYPE 命令显示文件中的所有数据。 需使用 "a+" 模式才能附加到通过 CTRL+Z EOF 标记终止的流文件。

指定 "r+""w+" 或 "a+" 访问类型时,允许读取和写入(文件将处于打开状态以进行“更新”)。 但是,当你从读取切换到写入时,输入操作必须遇到 EOF 标记。 如果没有 EOF,必须使用对文件定位函数的干预调用。 文件定位函数是 fsetposfseek 和 rewind 从写入切换到读取时,必须使用对 fflush 或文件定位函数的干预调用。

除了前面的值以外,可将以下字符追加到 mode 以指定换行符的转换模式。

t

在文本(转换)模式下打开。 在此模式下,CTRL+Z 将在输入时解释为 EOF 字符。 在使用 "a+" 打开以进行读取/写入的文件中,fopen 将检查文件末尾的 CTRL+Z 并将其移除(如果可能)。 这是因为使用 fseek 和 ftell 在以 CTRL+Z 结尾的文件中移动时,可能导致 fseek 在文件末尾附近错误运行。

在文本模式下,输入时,回车-换行组合将转换为单一的换行,输出时,换行字符将转换为回车-换行组合。 当 Unicode 流 I/O 函数在文本模式(默认设置)下运行时,源或目标流将假定为一系列多字节字符。 因此,Unicode 流输入函数将多字节字符转换为宽字符(就像调用 mbtowc 函数一样)。 出于同一原因,Unicode 流输出函数将宽字符转换为多字节字符(就像调用 wctomb 函数一样)。

b

在二进制(未转换)模式下打开;不进行涉及回车和换行字符的转换。

如果 t 或 b 在 mode 中未给出,则默认转换模式由全局变量 _fmode 定义。 如果 t 或 b 是该参数的前缀,则函数将失败并返回 NULL

有关如何在 Unicode 和多字节流 I/O 中使用文本和二进制模式的更多信息,请参见文本和二进制模式文件 I/O 和 文本和二进制模式下的 Unicode 流 I/O

c

启用关联 filename 的提交标志,以便在调用 fflush 或 _flushall 时将文件缓冲区的内容直接写入磁盘。

n

将关联 filename 的提交标志重置为“no-commit”。这是默认设置。 如果将程序显式链接到 COMMODE.OBJ,它还将重写全局提交标志。 除非将程序显式链接到 COMMODE.OBJ,全局提交标志默认为“no-commit”(请参见链接选项)。

N

指定文件不由子进程继承。

S

指定缓存针对(但不限于)从磁盘的顺序访问进行优化。

R

指定缓存针对(但不限于)从磁盘的随机访问进行优化。

T

将文件指定为临时。 如果可能,它不会刷新到磁盘。

D

将文件指定为临时。 最后一个文件指针关闭时,它将被删除。

ccs=ENCODING

指定要使用的编码字符集(UTF-8UTF-16LE 或 UNICODE)。 如果需要 ANSI 编码,请不要指定此字符集。

在 fopen 和 _fdopen 中使用的 mode 字符串的有效字符对应于在 _open 和 _sopen 中使用的 oflag 参数。

模式字符串中的字符

_open /_sopen 的等效 oflag 值。

a

_O_WRONLY | _O_APPEND (通常为 _O_WRONLY | _O_CREAT | _O_APPEND

a+

_O_RDWR | _O_APPEND (通常为 _O_RDWR | _O_APPEND | _O_CREAT 

r

_O_RDONLY

r+

_O_RDWR

w

_O_WRONLY (通常为 _O_WRONLY | _O_CREAT | _O_TRUNC

w+

_O_RDWR (通常为 _O_RDWR | _O_CREAT | _O_TRUNC

b

_O_BINARY

t

_O_TEXT

c

n

S

_O_SEQUENTIAL

R

_O_RANDOM

T

_O_SHORTLIVED

D

_O_TEMPORARY

ccs=UNICODE

_O_WTEXT

ccs=UTF-8

_O_UTF8

ccs=UTF-16LE

_O_UTF16

如果你使用 rb 模式、不必移植代码、希望读取大文件中的大部分内容或不担心网络性能,你可能还要考虑是否使用内存映射的 Win32 文件方式。

函数

必需的标头

fopen

<stdio.h>

_wfopen

<stdio.h> 或 <wchar.h>

有关兼容性的更多信息,请参见兼容性

c 、ntSRT 和 Dmode 选项是 fopen 和 _fdopen 的 Microsoft 扩展,不应在需要 ANSI 可移植性时使用。

以下程序打开两个文件。它使用 fclose 关闭第一个文件,使用 _fcloseall 关闭所有剩余文件。

// crt_fopen.c
// compile with: /W3
// This program opens two files. It uses
// fclose to close the first file and
// _fcloseall to close all remaining files.

#include <stdio.h>

FILE *stream, *stream2;

int main( void )
{
   int numclosed;

   // Open for read (will fail if file "crt_fopen.c" does not exist)
   if( (stream  = fopen( "crt_fopen.c", "r" )) == NULL ) // C4996
   // Note: fopen is deprecated; consider using fopen_s instead
      printf( "The file 'crt_fopen.c' was not opened\n" );
   else
      printf( "The file 'crt_fopen.c' was opened\n" );

   // Open for write 
   if( (stream2 = fopen( "data2", "w+" )) == NULL ) // C4996
      printf( "The file 'data2' was not opened\n" );
   else
      printf( "The file 'data2' was opened\n" );

   // Close stream if it is not NULL 
   if( stream)
   {
      if ( fclose( stream ) )
      {
         printf( "The file 'crt_fopen.c' was not closed\n" );
      }
   }

   // All other files are closed: 
   numclosed = _fcloseall( );
   printf( "Number of files closed by _fcloseall: %u\n", numclosed );
}
<span id="mt112" class="sentence" data-guid="36160afb7487ebf03eb3d7b8c058e6e0" data-source="" the="" file="" 'crt_fopen.c'="" was="" opened"="" xml:space="preserve">文件“crt_fopen.c”已打开
文件“data2”已打开
由 _fcloseall 所关闭的文件数量为:1

以下程序在具有 Unicode 编码的文本模式下创建文件(或在文件存在时覆盖文件)。然后,它将两个字符串写入文件并关闭文件。 输出是名为 _wfopen_test.xml 的文件,其中包含输出部分中的数据。

// crt__wfopen.c
// compile with: /W3
// This program creates a file (or overwrites one if
// it exists), in text mode using Unicode encoding.
// It then writes two strings into the file
// and then closes the file.
 
#include <stdio.h>
#include <stddef.h>
#include <stdlib.h>
#include <wchar.h>

#define BUFFER_SIZE 50

int main(int argc, char** argv)
{
wchar_t str[BUFFER_SIZE];
size_t  strSize;
FILE*   fileHandle;

    // Create an the xml file in text and Unicode encoding mode.
    if ((fileHandle = _wfopen( L"_wfopen_test.xml",L"wt+,ccs=UNICODE")) == NULL) // C4996
    // Note: _wfopen is deprecated; consider using _wfopen_s instead
    {
        wprintf(L"_wfopen failed!\n");
        return(0);
    }

    // Write a string into the file.
    wcscpy_s(str, sizeof(str)/sizeof(wchar_t), L"<xmlTag>\n");
    strSize = wcslen(str);
    if (fwrite(str, sizeof(wchar_t), strSize, fileHandle) != strSize)
    {
        wprintf(L"fwrite failed!\n");
    }

    // Write a string into the file.
    wcscpy_s(str, sizeof(str)/sizeof(wchar_t), L"</xmlTag>");
    strSize = wcslen(str);
    if (fwrite(str, sizeof(wchar_t), strSize, fileHandle) != strSize)
    {
        wprintf(L"fwrite failed!\n");
    }

    // Close the file.
    if (fclose(fileHandle))
    {
        wprintf(L"fclose failed!\n");
    }
    return 0;
}
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值