_setmode

Článek
06/09/2015

Nastaví režim překladu souboru.

int _setmode (    int fd,    int mode  );

Parametry

fd
Popisovač souboru.
mode
Nový režim překladu.

Vrácená hodnota

V případě úspěchu vrátí předchozí režim překladu.

Pokud jsou předány neplatné parametry této funkce, obslužné rutiny neplatný parametr vyvolání, jak je popsáno v Ověření parametru.Pokud je povoleno spuštění pokračovat, tato funkce vrátí hodnotu -1 a nastaví errno buď EBADF, která označuje popisovač souboru je neplatný nebo EINVAL, označující neplatný mode argument.

Další informace o těchto a dalších návratové kódy naleznete v tématu _doserrno, kód chyby, _sys_errlist a _sys_nerr.

Poznámky

_setmode Funkce nastaví na mode režim překladu souboru poskytnuté fd.Předávání _O_TEXT jako mode nastaví text (přeloženo) režimu.Silniční návratu – řádku informačního kanálu (CR-LF) kombinace jsou přeložit na jeden řádek znakem kanálu na vstup.Řádek informačního kanálu znaky jsou přeložit na CR-LF kombinace na výstup.Předávání _O_BINARY nastaví binární (nepřeložený) režim, ve kterém jsou tyto překlady potlačovány.

Můžete také předat _O_U16TEXT, _O_U8TEXT, nebo _O_WTEXT Chcete-li povolit režim Unicode, jak je uvedeno ve druhém příkladu dále v tomto dokumentu._setmodeChcete-li změnit výchozí režim překladu se obvykle používá stdin a stdout, ale můžete jej použít v libovolném souboru.Použijete-li _setmode do popisovače souboru pro datový proud, volejte _setmode před provedením jakékoli vstupních nebo výstupních operací v datovém proudu.

Upozornění
Pokud jste zapsat data do souboru datového proudu explicitně vyprázdnění kódu s použitím fflush před použitím _setmode Chcete-li změnit režim.Pokud není vyprázdnit kód, můžete získat neočekávané chování.Pokud ještě zapsat data do datového proudu, není třeba vyprázdnění kód.

Požadavky

Rutina	Požadovaný hlavičkový soubor	Volitelné záhlaví
_setmode	< io.h >	< fcntl.h >

Další informace o kompatibilitě, podívejte se na téma kompatibility.

Příklad

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