ИМЯ¶

btowc - преобразует один байт в широкий символ

ОБЗОР¶

#include <wchar.h>

wint_t btowc(int c);

ОПИСАНИЕ¶

Функция btowc() преобразует аргумент c, который считает многобайтовой последовательностью с длиной 1 и находящийся в начальном состоянии сдвига, в широкий символ, и возвращает его. Если значение c равно EOF или не содержит правильной многобайтовой последовательности длиной 1, то btowc() возвращает WEOF.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶

Функция btowc() возвращает широкий символ, преобразованный из c. Если значение c равно EOF или содержит некорректную многобайтовую последовательность длиной 1, то возвращается WEOF.

СООТВЕТСТВИЕ СТАНДАРТАМ¶

C99, POSIX.1-2001.

ЗАМЕЧАНИЯ¶

Поведение btowc() зависит от категории LC_CTYPE текущий локали.

Эту функцию не стоит использовать. Она не работает с кодировками, имеющими состояние, и абсолютно бесполезна для трактовки байтов, отличных от многобайтовых последовательностей. Вместо неё используйте функцию mbtowc(3) или нитебезопасную mbrtowc(3).

СМОТРИТЕ ТАКЖЕ¶

mbrtowc(3), mbtowc(3), wctob(3)