_set_fmode
ファイル入出力操作の既定のファイル変換モードを設定します。
構文
errno_t _set_fmode(
int mode
);
パラメーター
mode
ファイルの変換モードを _O_TEXT
または _O_BINARY
に設定します。
戻り値
正常終了した場合は 0 を、失敗した場合はエラー コードを返します。 mode
が_O_TEXT
、_O_BINARY
、または_O_WTEXT
されていない場合は、「パラメーターの検証で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、この関数は errno
を EINVAL
に設定し、EINVAL
を返します。
解説
この関数は、 _fmode
グローバル変数を設定します。 この変数は、ファイル入出力操作 _open
および _pipe
の既定のファイル変換モードを指定します。
_O_TEXT
および _O_BINARY
は Fcntl.h で定義されています。 EINVAL
は Errno.h で定義されています。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。
要件
ルーチンによって返される値 | 必須ヘッダー | オプション ヘッダー |
---|---|---|
_set_fmode |
<stdlib.h> | <fcntl.h>、<errno.h> |
互換性の詳細については、「 Compatibility」を参照してください。
例
// 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