_write
ファイルにデータを書き込みます。
int _write( int fd, const void *buffer, unsigned int count );
パラメーター
fd
データを書き込むファイルのファイル記述子。buffer
書き込むデータ。count
バイト数。
戻り値
成功した場合、_write は実際に書き込まれたバイト数を返します。 ディスク上に残っている実際の領域が、この関数がディスクに書き込もうとしているバッファーのサイズよりも小さい場合、_write は失敗し、バッファーの内容はディスクにフラッシュされません。 戻り値 -1 はエラーを示します。 無効なパラメーターが渡されると、「パラメーターの検証」で説明されているように、この関数は無効なパラメーター ハンドラーを呼び出します。 実行の継続が許可された場合、この関数は -1 を返し、errno は次の 3 つの値のいずれかに設定されます。EBADF は、ファイル記述子が無効であるか、ファイルが書き込み用に開かれていないことを意味します。ENOSPC は、操作対象のデバイス上に十分な領域が残っていないことを意味します。EINVAL は、buffer が null ポインターであったか、Unicode モードで奇数の count のバイトがファイルに書き込むために渡されたことを意味します。
リターン コードの詳細については、「errno、_doserrno、_sys_errlist、および _sys_nerr」を参照してください。
ファイルがテキスト モードで開かれた場合、各ライン フィード文字は出力ではキャリッジ リターンとライン フィードのペアで置き換えられます。 この置き換えは、戻り値には影響しません。
ファイルが Unicode 変換モードで開かれた場合 (たとえば、_open または _sopen と、_O_WTEXT、_O_U16TEXT、または _O_U8TEXT を含むモード パラメーターを使用することで fd が開かれた場合や、fopen と ccs=UNICODE、ccs=UTF-16LE、または ccs=UTF-8 を含むモード パラメーターを使用して開かれた場合や、_setmode を使用してモードが Unicode 変換モードに変更された場合など)、buffer は UTF-16 データを含む wchar_t の配列へのポインターとして解釈されます。 このモードで奇数バイトの書き込みを試みると、パラメーター検証エラーが発生します。
解説
_write 関数は、count のバイトを buffer から fd に関連付けられたファイルにコピーします。 書き込み操作は、指定されたファイルに関連付けられたファイル ポインター (存在する場合) の現在の位置で開始されます。 ファイルが追加用に開かれている場合、操作はファイルの現在の末尾で開始されます。 書き込み操作の後、ファイル ポインターは実際に書き込まれたバイト数の分、増加します。
ファイルへの書き込みがテキスト モードで開かれた場合、_write は CTRL+Z 文字を論理的なファイルの終わりとして扱います。 デバイスに書き込むときに、_write はバッファー内の CTRL+Z 文字を出力の終端として扱います。
必要条件
ルーチン |
必須ヘッダー |
---|---|
_write |
<io.h> |
互換性の詳細については、「互換性」を参照してください。
使用例
// crt__write.c
//
// This program opens a file for output and uses _write to write
// some bytes to the file.
#include <io.h>
#include <stdio.h>
#include <stdlib.h>
#include <fcntl.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <errno.h>
#include <share.h>
char buffer[] = "This is a test of '_write' function";
int main( void )
{
int fileHandle = 0;
unsigned bytesWritten = 0;
if ( _sopen_s(&fileHandle, "write.o", _O_RDWR | _O_CREAT,
_SH_DENYNO, _S_IREAD | _S_IWRITE) )
return -1;
if (( bytesWritten = _write( fileHandle, buffer, sizeof( buffer ))) == -1 )
{
switch(errno)
{
case EBADF:
perror("Bad file descriptor!");
break;
case ENOSPC:
perror("No space left on device!");
break;
case EINVAL:
perror("Invalid parameter: buffer was NULL!");
break;
default:
// An unrelated error occured
perror("Unexpected error!");
}
}
else
{
printf_s( "Wrote %u bytes to file.\n", bytesWritten );
}
_close( fileHandle );
}