wcrtomb()

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

Прототип:

#include <wchar.h>
size_t wcrtomb( char *s,
wchar_t wc,
mbstate_t *ps );

Аргументы:

s
NULL или указатель, по которому функция может сохранить многобайтовую последовательность.
wc
Широкий символ, который необходимо преобразовать.
ps
Внутренний указатель, который позволяет функции wcrtomb() дополнить функицонал wctomb() возможностью перезапуска; Если ps равен NULL, функция использует свою внутреннюю переменную. Чтоб определить статус этой переменной, необходимо вызвать mbsinit().

Библиотека:

libc

Описание:

Функция wcrtomb() определяет количество байт, которое необходимо для представления широкого символа wc в виде многобайтовой последовательности с максимальной длиной MB_CUR_MAX, и сохраняет ее по адресу s.

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

Возвращаемое значение:

Количество сохраненных байт, или (size_t)-1, если переменная wc является некорректным широким символом.

Коды ошибок:

EILSEQ
Недопустимый широкий символ.
EINVAL
Переменная ps указывает на недопустимое состояние преобразования.

Классификация:

ANSI, POSIX 1003.1

Безопасность использования
Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

wcsrtombs(), wcstod(), wcstof(), wcstold(), wcstoimax(), wcstoumax(), wcstok(), wcstol(), wcstoll(), wcstombs(), wcstoul(), wcstoull(), wctob(), wctomb()




Предыдущий раздел: Описание API системной библиотеки