std::mbrtoc8

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Строки

Строки с завершающим нулём

Однобайтовые строки

Многобайтовые строки

Широкие строки

Классы

basic_string

basic_string_view (C++17)

char_traits

 

Многобайтовые строки с завершающим нулём

Широкие/многобайтовые преобразования
mbsinit
mbtowc mbstowcs btowc mbrtowc mbsrtowcs mbrtoc8 (C++20) mbrtoc16 (C++11) mbrtoc32 (C++11)     mblen	wctomb wcstombs wctob wcrtomb wcsrtombs c8rtomb (C++20) c16rtomb (C++11) c32rtomb (C++11) mbrlen
Типы
mbstate_t

 

<tbody> </tbody>

Определено в заголовочном файле <cuchar>
std::size_t mbrtoc8( char8_t* pc8, const char* s, std::size_t n, std::mbstate_t* ps );		(начиная с C++20)

Преобразует узкий многобайтовый символ в кодировку UTF-8.

Если s не является нулевым указателем, проверяет не более n байт многобайтовой символьной строки, начиная с байта, на который указывает s, чтобы определить количество байтов, необходимых для завершения следующего многобайтового символа (включая любые последовательности сдвига). Если функция определяет, что следующий многобайтовый символ в s является полным и допустимым, преобразует его в UTF-8 и сохраняет первую кодовую единицу UTF-8 в *pc8 (если pc8 не равно нулю).

Если кодировка UTF-8 многобайтового символа в *s состоит из более чем одной кодовой единицы UTF-8, то после первого вызова этой функции *ps обновляется таким образом, при котором следующий вызов mbrtoc8 запишет дополнительные кодовые единицы UTF-8 без учёта *s.

Если s является нулевым указателем, значения n и pc8 игнорируются, и вызов эквивалентен std::mbrtoc8(nullptr, "", 1, ps).

Если созданная кодовая единица UTF-8 равна u8'\0', состояние преобразования *ps представляет начальное состояние сдвига.

Многобайтовая кодировка, используемая этой функцией, определяется текущей активной локалью C.

Параметры

pc8	—	указатель на место, куда будут записаны результирующие кодовые единицы UTF-8
s	—	указатель на многобайтовую строку символов, используемую в качестве входных данных
n	—	ограничение на количество байтов в s, которые могут быть проверены
ps	—	указатель на объект состояния преобразования, используемый при интерпретации многобайтовой строки

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

Первое из следующих применимых условий:

• 0, если символ, преобразованный из s (и сохранённый в *pc8, если он не равен нулю), был нулевым символом.
• количество байтов [1...n] многобайтового символа, успешно преобразованного из s.
• static_cast<std::size_t>(-3), если следующая кодовая единица UTF-8 из символа, кодировка которого состоит из нескольких кодовых единиц, теперь записана в *pc8. В этом случае никакие входные байты не обрабатываются.
• static_cast<std::size_t>(-2), если следующие n байтов представляют собой неполный, но пока действительный многобайтовый символ. В *pc8 ничего не записывается.
• static_cast<std::size_t>(-1), если возникает ошибка кодирования. В *pc8 ничего не записывается, значение EILSEQ сохраняется в errno, а значение *ps не указано.

Смотрите также

c8rtomb (C++20)	преобразует строку UTF-8 в узкую многобайтовую кодировку (функция)
Документация C по mbrtoc8