ИМЯ

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

LIBRARY

       Standard C library (libc, -lc)

СИНТАКСИС

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

ПЕРЕВОД

       Русский    перевод    этой    страницы    руководства    был    сделан    Artyom    Kunyov
       <artkun@guitarplayer.ru>, Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitriy Ovchinnikov
       <dmitriyxt5@gmail.com>,     Dmitry     Bolkhovskikh     <d20052005@yandex.ru>,    ITriskTI
       <ITriskTI@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

       Этот  перевод  является  бесплатной  документацией;  прочитайте  Стандартную  общественную
       лицензию GNU версии 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ или более позднюю, чтобы
       узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

       Если вы обнаружите ошибки в переводе  этой  страницы  руководства,  пожалуйста,  отправьте
       электронное письмо на ⟨man-pages-ru-talks@lists.sourceforge.net⟩.