ИМЯ

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

СТАНДАРТЫ

C11, POSIX.1-2008.

ИСТОРИЯ

C99, POSIX.1-2001.

ПРИМЕЧАНИЯ

Поведение 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 (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику по его адресу электронной почты или по адресу списка рассылки русских переводчиков.