_set_fmode

  • 项目

为文件 I/O 操作设置默认文件转换模式。

语法

errno_t _set_fmode(
   int mode
);

参数

mode
所需的文件转换模式：_O_TEXT 或 _O_BINARY。

返回值

如果成功，则返回零；如果失败，则返回错误代码。 如果 mode不是 _O_TEXT、_O_BINARY 或 _O_WTEXT，会调用无效参数处理程序，如参数验证中所述。 如果允许执行继续，则该函数将 errno 设置为 EINVAL 并返回 EINVAL。

备注

该函数会设置 _fmode 全局变量。 此变量为文件 I/O 操作 _open 和 _pipe 指定默认的文件转换模式。

_O_TEXT 和 _O_BINARY 在 Fcntl.h 中进行定义。 EINVAL 在 Errno.h 中进行定义。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

要求

例程 必需的标头 可选标头
_set_fmode <stdlib.h> <fcntl.h>、<errno.h>

有关兼容性的详细信息，请参阅 兼容性。

示例

// crt_set_fmode.c
#include <stdlib.h>
#include <stdio.h>
#include <fcntl.h>     /* for _O_TEXT and _O_BINARY */
#include <errno.h>     /* for EINVAL */
#include <sys\stat.h>  /* for _S_IWRITE */
#include <share.h>     /* for _SH_DENYNO */

int main()
{
   int mode, fd, ret;
   errno_t err;
   int buf[12] = { 65, 66, 67, 68, 69, 70, 71, 72, 73, 74,
                   75, 76 };
   char * filename = "fmode.out";

   err = _get_fmode(&mode);
   if (err == EINVAL)
   {
      printf( "Invalid parameter: mode\n");
      return 1;
   }
   else
      printf( "Default Mode is %s\n", mode == _O_TEXT ? "text" :
              "binary");

   err = _set_fmode(_O_BINARY);
   if (err == EINVAL)
   {
      printf( "Invalid mode.\n");
      return 1;
   }

   if ( _sopen_s(&fd, filename, _O_RDWR | _O_CREAT, _SH_DENYNO, _S_IWRITE | _S_IREAD) != 0 )
   {
      printf( "Error opening the file %s\n", filename);
      return 1;
   }

   if (ret = _write(fd, buf, 12*sizeof(int)) < 12*sizeof(int))
   {
      printf( "Problem writing to the file %s.\n", filename);
      printf( "Number of bytes written: %d\n", ret);
   }

   if (_close(fd) != 0)
   {
      printf("Error closing the file %s. Error code %d.\n",
             filename, errno);
   }

   system("type fmode.out");
}

Default Mode is binary
A   B   C   D   E   F   G   H   I   J   K   L

另请参阅

_fmode
_get_fmode
_setmode
文本和二进制模式文件 I/O