Linux Man на русском

  User    Syst    Libr    Device    Files    Other    Admin  



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

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


ОБЗОР

#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).