ИМЯ

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

ОБЗОР

#include <wchar.h>

wint_t btowc(int c);

ОПИСАНИЕ

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

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

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

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).

Интерфейс	Атрибут	Значение
btowc()	Безвредность в нитях	MT-Safe

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

POSIX.1-2001, POSIX.1-2008, C99.

ЗАМЕЧАНИЯ

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

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

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

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