_setmode

Задает режим преобразования файлов.

Синтаксис

int _setmode (
   int fd,
   int mode
);

Параметры

fd
Дескриптор файла.

mode
Новый режим преобразования.

Возвращаемое значение

При успешном выполнении возвращает предыдущий режим преобразования.

Если функции переданы недопустимые параметры, вызывается обработчик недопустимого параметра, как описано в разделе Parameter Validation. Если выполнение может быть продолжено, эта функция возвращает-1 и задает errno для значение EBADF , которое указывает на недопустимый дескриптор файла, или EINVAL , которое указывает на недопустимый mode аргумент.

Дополнительные сведения об этих и других кодах возврата см. в разделе,, errno_sys_errlist и _sys_nerr.

Комментарии

Функция _setmode задает в качестве параметра mode режим преобразования файла, заданный fd. При передаче _O_TEXT как параметра mode задается текстовый (преобразованный) режим. Сочетания символов возврата каретки и перевода строки (CR-LF) преобразуются в один символ перевода строки во входных данных. Символы перевода строки преобразуются в комбинацию CR-LF в выводе. Передача _O_BINARY задает двоичный режим (без преобразования), в котором такие преобразования подавляются.

Можно также передать _O_U16TEXT , _O_U8TEXT или, _O_WTEXT чтобы включить режим Юникода, как показано во втором примере далее в этом документе.

Внимание!

Режим Юникода предназначен для расширенных функций печати (например, wprintf ) и не поддерживается для узких функций печати. Использование небольшой функции печати в потоке режима Юникод вызывает утверждение.

_setmode, как правило, используется для изменения режима преобразования stdin и stdout по умолчанию, однако ее можно использовать для любого файла. Если вы применяете функцию _setmode к дескриптору файла для потока, ее необходимо вызывать _setmode до выполнения любых операций ввода или вывода в потоке.

Внимание!

Если данные записываются в файловый поток, явно очистите код с помощью, fflush прежде чем использовать _setmode для изменения режима. Если не выполнить сброс кода, может возникнуть непредвиденное поведение. Если данные не записывались в поток, выполнять сброс кода не нужно.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это, см. раздел глобальное состояние в CRT.

Требования

Подпрограмма Обязательный заголовок Необязательные заголовки
_setmode <io.h> <fcntl.h>

Дополнительные сведения о совместимости см. в разделе Compatibility.

Пример. Использование _setmode для изменения 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

Пример. Использование _setmode для изменения 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;
}

См. также

Обработка файлов
, _wcreat
, _wfopen
, _wopen
_set_fmode