ИМЯ¶

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

СИНТАКСИС¶

#include <wchar.h>

size_t wcrtomb(char *s, wchar_t wc, mbstate_t *ps);

ОПИСАНИЕ¶

В основном, функция предназначена для работы, когда s не равно NULL и wc не равно широкому символу null (L'\0'). В этом случае функция wcrtomb() преобразует широкий символ wc в его многобайтовое представление и заносит его в начало массива символов, на который указывает s. Функция обновляет состояние сдвига *ps и возвращает длину получившегося многобайтового представления, то есть количество байтов, записанных в s.

Также есть вариант, когда s не равно NULL, но wc равно широкому символу null (L'\0'). В этом случае функция wcrtomb() заносит в массив символов, на который указывает s, последовательность сдвига, оканчивающуюся байтом '\0', необходимую для возврата *ps в начальное положение. Состояние сдвига *ps обновляется (переходит в исходное) и возвращается длина последовательности сдвига плюс один, то есть количество байт, записанных в s.

Третий случай — это когда s равно NULL. Тогда wc игнорируется, а функция возвращает

wcrtomb(buf, L'\0', ps)

где buf — внутренний анонимный буфер.

Во всех вышеперечисленных случаях, если ps равно NULL, то используется статическое анонимное состояние, известное только функции wcrtomb().

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

Функция wcrtomb() возвращает количество байтов, которые уже записаны или должны быть записаны в массив, на который указывает s. Если значение wc не может быть представлено как многобайтовая последовательность (в соответствии с текущей локалью), то возвращается (size_t) -1, а errno присваивается значение EILSEQ.

АТРИБУТЫ¶

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

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

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

ЗАМЕЧАНИЯ¶

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

Передавать NULL в качестве ps небезопасно при работе с нитями.

СМ. ТАКЖЕ¶

mbsinit(3), wcsrtombs(3)

ЗАМЕЧАНИЯ¶

Эта страница является частью проекта Linux man-pages версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД¶

Русский перевод этой страницы руководства был сделан Azamat Hackimov <azamat.hackimov@gmail.com> и Yuri Kozlov <yuray@komyakino.ru>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

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