_setmode
Nastaví režim překladu souborů.
Syntaxe
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 této funkci předány neplatné parametry, vyvolá se obslužná rutina neplatného parametru, jak je popsáno v ověření parametru. Pokud je spuštění povoleno pokračovat, vrátí tato funkce hodnotu -1 a nastaví errno
buď EBADF
, což označuje neplatný popisovač souboru, nebo EINVAL
, který označuje neplatný mode
argument.
Další informace o těchto a dalších návratových kódech naleznete v tématu , , , a_sys_nerr
. _sys_errlist
_doserrno
errno
Poznámky
Funkce _setmode
nastaví mode
režim překladu souboru poskytnutého fd
. Předávání _O_TEXT
jako mode
nastaví režim textu ANSI (tj. přeložený). Kombinace vrácené čáry (CR-LF) se při vstupu překládají do jednoho znaku odřádkování. Znaky odřádkování se při výstupu překládají do kombinací CR-LF. Předávání _O_BINARY
binárního (nepřeledného) režimu, ve kterém jsou tyto překlady potlačeny.
Můžete také předat _O_U16TEXT
, _O_U8TEXT
nebo _O_WTEXT
povolit režim Unicode, jak je znázorněno v druhém příkladu dále v tomto dokumentu.
Upozornění
Režim Unicode je určen pro široké tiskové funkce (například wprintf
) a není podporován pro úzké tiskové funkce. Použití úzké tiskové funkce v streamu režimu Unicode aktivuje assert.
_setmode
se obvykle používá k úpravě výchozího režimu překladu stdin
a stdout
, ale můžete ho použít v libovolném souboru. Pokud použijete _setmode
popisovač souboru pro datový proud, zavolejte _setmode
před provedením vstupních nebo výstupních operací ve streamu.
Upozornění
Pokud zapisujete data do datového proudu souboru, explicitně vyprázdněte kód před fflush
_setmode
změnou režimu. Pokud kód nevyprázdníte, může dojít k neočekávanému chování. Pokud jste do datového proudu nezapisovali data, nemusíte kód vyprázdnit.
Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.
Požadavky
Rutina | Požadovaný hlavičkový soubor | Volitelné hlavičky |
---|---|---|
_setmode |
<io.h> |
<fcntl.h> |
Další informace o kompatibilitě najdete v tématu Kompatibilita.
Příklad: Použití _setmode
ke změně 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
Příklad: Použití _setmode
ke změně stdoutu
// 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;
}
Viz také
Zpracování souborů
_creat
, _wcreat
fopen
, _wfopen
_open
, _wopen
_set_fmode