_write
將資料寫入檔案。
語法
int _write(
int fd,
const void *buffer,
unsigned int count
);
參數
fd
資料要寫入至其中之檔案的檔案描述項。
buffer
要寫入的資料。
count
位元組數。
傳回值
如果成功， _write 則傳回寫入的位元組數目。 如果磁碟上剩餘的實際空間小於函式嘗試寫入磁碟的緩衝區大小， _write 則會失敗，而且不會排清任何緩衝區的內容至磁碟。 -1 的傳回值表示錯誤。 如果傳遞了無效的參數，此函式會叫用無效的參數處理程式，如參數驗證中所述。 如果允許繼續執行，則函式會傳回 -1，並 errno 設定為三個值的其中一個： EBADF，這表示檔案描述元無效，或檔案無法開啟以進行寫入 ENOSPC;這表示裝置上沒有足夠的空間可供作業使用;或 EINVAL，這表示 buffer 為 Null 指標，或是在 Unicode 模式中傳遞位元組的奇數 count 。
如需這些傳回碼和其他傳回碼的詳細資訊，請參閱errno、 _sys_errlist_doserrno和 _sys_nerr。
如果檔案以文字模式開啟，則輸出中的每個換行字元會取代為歸位字元換行字元組。 取代不會影響傳回值。
當檔案以 Unicode 轉譯模式開啟時，例如，如果使用 fd 或 和 _sopen 包含 、 _O_U16TEXT或_O_U8TEXT的 mode 參數開啟_open，或是使用 fopen 開啟，以及包含 、 ccs=UTF-16LE或 ccs=UTF-8的 mode 參數ccs=UNICODE_O_WTEXT，或是模式使用 _setmode變更為 Unicode 轉譯模式，buffer則會解譯為包含UTF-16數據的陣列wchar_t指標。 嘗試以此模式寫入奇數位元組會導致參數驗證錯誤。
備註
_write 函式會將 count 個位元組從 buffer 寫入至與 fd 相關的檔案。 寫入作業會從與指定檔案相關之檔案指標 (若有的話) 的目前位置開始。 若檔案是開啟為以供附加，則作業會在檔案的目前結尾開始。 寫入作業之後，檔案指標會隨著寫入的位元組數目而增加。
當寫入以文字模式開啟的檔案時， _write 會將 CTRL+Z 字元視為檔案的邏輯結尾。 寫入裝置時， _write 會將緩衝區中的 CTRL+Z 字元視為輸出終止符。
根據預設，此函式的全域狀態會限定於應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。
需求
| 常式 | 必要的標頭 |
|---|---|
_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 occurred
perror("Unexpected error!");
}
}
else
{
printf_s( "Wrote %u bytes to file.\n", bytesWritten );
}
_close( fileHandle );
}
Wrote 36 bytes to file.