_setmode
Imposta la modalità di conversione di file.
int _setmode ( int fd, int mode );
Parametri
fd
Descrittore di file.mode
Nuova modalità di conversione.
Valore restituito
In caso di esito positivo, restituisce la modalità di conversione precedente.
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, questa funzione restituisce –1 e imposta errno su EBADF, che indica un descrittore di file non valido, o EINVAL, che indica un argomento mode non valido.
Per altre informazioni su questi e altri codici restituiti, vedere _doserrno, errno, _sys_errlist, and _sys_nerr.
Note
La funzione _setmode imposta su mode la modalità di conversione del file specificato da fd. Se si passa _O_TEXT come mode, sarà impostata la modalità testo (conversione). Le combinazioni di ritorno a capo-avanzamento riga sono convertite in un singolo carattere di avanzamento riga in fase di input. I caratteri di avanzamento riga sono convertiti in combinazioni di ritorno a capo-avanzamento riga in fase di output. Se si passa _O_BINARY, sarà impostata la modalità binaria (nessuna conversione), in cui queste conversioni sono eliminate.
È anche possibile passare _O_U16TEXT, _O_U8TEXT o _O_WTEXT per abilitare la modalità Unicode, come illustrato nel secondo esempio più avanti in questo documento. _setmode è in genere usato per modificare la modalità di traduzione predefinita di stdin e stdout, ma è possibile usarlo per qualsiasi file. Se si applica _setmode al descrittore di file per un flusso, chiamare _setmode prima di eseguire qualsiasi operazione di input o output nel flusso.
Avviso
Se si scrivono dati in un flusso di file, scaricare esplicitamente il codice usando fflush prima di usare _setmode per cambiare la modalità.Se non si scarica il codice, è possibile che si ottenga comportamento imprevisto.Se non sono stati scritti dati nel flusso, non sarà necessario scaricare il codice.
Requisiti
Routine |
Intestazione obbligatoria |
Intestazioni facoltative |
|---|---|---|
_setmode |
<io.h> |
<fcntl.h> |
Per altre informazioni sulla compatibilità, vedere Compatibilità.
Esempio
// crt_setmode.c
// This program uses _setmode to change
// stdin from text mode to binary mode.
#include <stdio.h>
#include <fcntl.h>
#include <io.h>
int main( void )
{
int result;
// Set "stdin" to have binary mode:
result = _setmode( _fileno( stdin ), _O_BINARY );
if( result == -1 )
perror( "Cannot set mode" );
else
printf( "'stdin' successfully changed to binary mode\n" );
}
// crt_setmodeunicode.c
// This program uses _setmode to change
// stdout to Unicode. Cyrillic and Ideographic
// characters will appear on the console (if
// your console font supports those character sets).
#include <fcntl.h>
#include <io.h>
#include <stdio.h>
int main(void) {
_setmode(_fileno(stdout), _O_U16TEXT);
wprintf(L"\x043a\x043e\x0448\x043a\x0430 \x65e5\x672c\x56fd\n");
return 0;
}