_write
Scrive i dati in un file.
int _write( int fd, const void *buffer, unsigned int count );
Parametri
fd
Descrittore di file del file in cui vengono scritti i dati.buffer
Dati da scrivere.count
Numero di byte.
Valore restituito
Se ha esito positivo, _write restituisce il numero di byte effettivamente scritti. Se lo spazio effettivo rimanente sul disco è inferiore alle dimensioni del buffer che la funzione sta tentando di scrivere sul disco, _write ha esito negativo e no scarica i contenuti del buffer nel disco. Un valore restituito di –1 indica un errore. Se a questa funzione sono passati parametri non validi, sarà richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce -1 e errno viene impostato su uno di tre valori: EBADF, che indica che il descrittore di file non è valido o che il file non è aperto per la scrittura; ENOSPC, che indica che nel dispositivo non vi è spazio sufficiente per l'operazione; oppure EINVAL, che indica che buffer è un puntatore Null o che è stato passato un parametro count di byte dispari per la scrittura in un file in modalità Unicode.
Per altre informazioni su questi e altri codici restituiti, vedere errno, _doserrno, _sys_errlist, and _sys_nerr.
Se il file viene aperto in modalità testo, nell'output ogni carattere di avanzamento riga è sostituito da una coppia di segni di avanzamento riga con avanzamento riga. La sostituzione non interessa il valore restituito.
Quando il file viene aperto nella modalità di conversione Unicode, ad esempio se fd viene aperto con _open o _sopen e un parametro modalità che include _O_WTEXT, _O_U16TEXT o _O_U8TEXT, o se viene aperto con fopen e un parametro modalità che include ccs=UNICODE, ccs=UTF-16LE o ccs=UTF-8, o se la modalità viene sostituita con una modalità di conversione Unicode tramite _setmode, buffer viene interpretato come un puntatore a una matrice di wchar_t che contiene dati UTF-16. Un tentativo di scrivere un numero dispari di byte in questa modalità causerà un errore di convalida del parametro.
Note
La funzione _write scrive byte count da buffer nel file associato a fd. L'operazione di scrittura inizia dalla posizione corrente del puntatore del file (se presente) associato al file specifico. Se il file è aperto per l'aggiunta, l'operazione inizia dalla fine corrente del file. Al termine dell'operazione di scrittura, il puntatore del file viene incrementato del numero di byte effettivamente scritti.
Durante la scrittura nei file aperti in modalità testo, _write considera un carattere CTRL+Z come la fine del file logica. Durante la scrittura in un dispositivo, _write considera un carattere CTRL+Z nel buffer come un terminatore di output.
Requisiti
Routine |
Intestazione obbligatoria |
|---|---|
_write |
<io.h> |
Per altre informazioni sulla compatibilità, vedere Compatibilità.
Esempio
// 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 );
}