_setmode
Задает режим преобразования файлов.
int _setmode ( int fd, int mode );
Параметры
fd
Дескриптор файла.mode
Новый режим преобразования.
Возвращаемое значение
При успешном выполнении возвращает предыдущий режим преобразования.
Если в эту функцию передается недопустимый параметр, вызывается обработчик недопустимых параметров, как описано в разделе Проверка параметров. Если продолжение выполнения разрешено, эта функция возвращает значение -1 и задает для errno значение EBADF, которое указывает на недопустимый дескриптор файла, или EINVAL, которое указывает на недопустимый аргумент mode.
Дополнительные сведения об этих и других кодах возврата см. в разделе _doserrno, errno, _sys_errlist и _sys_nerr.
Заметки
Функция _setmode задает в качестве параметра mode режим преобразования файла, заданный fd. При передаче _O_TEXT как параметра mode задается текстовый (преобразованный) режим. Комбинация символов возврата каретки и перевода строки (CR-LF) преобразуется в один символ перевода строки в выводе. Символы перевода строки преобразуются в комбинацию CR-LF в выводе. Передача _O_BINARY задает двоичный режим (без преобразования), в котором такие преобразования подавляются.
Можно также передать флаги _O_U16TEXT, _O_U8TEXT или _O_WTEXT, чтобы включить режим Юникода, как демонстрируется во втором примере ниже в этом документе. _setmode, как правило, используется для изменения режима преобразования stdin и stdout по умолчанию, однако ее можно использовать для любого файла. Если вы применяете функцию _setmode к дескриптору файла для потока, ее необходимо вызывать до выполнения любых операций ввода или вывода в потоке.
Предупреждение
Если выполняется запись данных в файловый поток, необходимо явно сбросить код, используя fflush перед использованием функции _setmode для изменения режима.Если не выполнить сброс кода, может возникнуть непредвиденное поведение.Если данные не записывались в поток, выполнять сброс кода не нужно.
Требования
Подпрограмма |
Обязательный заголовок |
Необязательные заголовки |
|---|---|---|
_setmode |
<io.h> |
<fcntl.h> |
Дополнительные сведения о совместимости см. в разделе Совместимость.
Пример
// 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;
}