_setmode

Imposta la modalità di conversione di file.

Sintassi

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 vengono passati parametri non validi, viene 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 EBADFsu , che indica un descrittore di file non valido o EINVAL, che indica un argomento non valido mode .

Per altre informazioni su questi e altri codici restituiti, vedere errno, _doserrno, _sys_errliste _sys_nerr.

Osservazioni:

La funzione _setmode imposta su mode la modalità di conversione del file specificato da fd. Passando _O_TEXT come mode imposta la modalità di testo ANSI (ovvero tradotta). Le combinazioni di avanzamento riga ritorno a capo (CR-LF) vengono convertite in un singolo carattere di avanzamento riga all'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_U8TEXTo _O_WTEXT per abilitare la modalità Unicode, come illustrato nel secondo esempio più avanti in questo documento.

Attenzione

La modalità Unicode è per le funzioni di stampa wide (ad esempio, wprintf) e non è supportata per le funzioni di stampa strette. L'uso di una funzione di stampa stretta in un flusso in modalità Unicode attiva un'asserzione.

_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.

Attenzione

Se si scrivono dati in un flusso di file, scaricare in modo esplicito il codice usando fflush prima di usare _setmode per modificare 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.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Requisiti

Ciclo	Intestazione obbligatoria	Intestazioni facoltative
_setmode	<io.h>	<fcntl.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio: usare _setmode per modificare stdin

// 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" );
}

'stdin' successfully changed to binary mode

Esempio: usare _setmode per modificare stdout

// 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;
}

Vedi anche

Gestione dei file
_creat, _wcreat
fopen, _wfopen
_open, _wopen
_set_fmode