std::c32rtomb

std::size_t c32rtomb( char* s, char32_t c32, std::mbstate_t* ps );

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

Если s не является указателем на null, функция определяет количество байтов, необходимых для хранения многобайтового представления символа c32 (включая любые последовательности смены кодировки и учитывая текущее состояние преобразования многобайтовых последовательностей *ps), и сохраняет это многобайтовое представление в массиве символов, указанном первым элементом s, обновляя *ps по мере необходимости. Эта функция может записать не более MB_CUR_MAX байтов.

Если s является указателем на null, вызов эквивалентен std::c32rtomb(buf, U'\0', ps) для некоторого внутреннего буфера buf.

Если c32 является нулевым широким символом U'\0', сохраняется нулевой байт, предваряемый любой необходимой последовательностью смены кодировки для восстановления начального состояния смены кодировки, и параметр состояния преобразования *ps обновляется, чтобы отразить начальное состояние смены кодировки.

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

Параметры

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

При успешном выполнении функция возвращает количество байтов (включая любые последовательности смены кодировки), записанных в массив символов, указанный первым элементом s. Это значение может быть ​0​, например, при обработке первого char32_t в много-char32_tсимвольном последовательности (не встречается в UTF-32).

При ошибке (если c32 не является допустимым 32-битным символом), функция возвращает -1, сохраняет EILSEQ в errno и оставляет *ps в неопределённом состоянии.

Пример

#include <climits>
#include <clocale>
#include <cuchar>
#include <iomanip>
#include <iostream>
#include <string_view>
 
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    std::u32string_view strv = U"zß水🍌"; // or z\u00df\u6c34\U0001F34C
    std::cout << "Processing " << strv.size() << " UTF-32 code units: [ ";
    for (char32_t c : strv)
        std::cout << std::showbase << std::hex << static_cast<int>(c) << ' ';
    std::cout << "]\n";
 
    std::mbstate_t state{};
    char out[MB_LEN_MAX]{};
    for (char32_t c : strv)
    {
        std::size_t rc = std::c32rtomb(out, c, &state);
        std::cout << static_cast<int>(c) << " converted to [ ";
        if (rc != (std::size_t) - 1)
            for (unsigned char c8 : std::string_view{out, rc})
                std::cout << +c8 << ' ';
        std::cout << "]\n";
    }
}

Processing 4 UTF-32 code units: [ 0x7a 0xdf 0x6c34 0x1f34c ]
0x7a converted to [ 0x7a ]
0xdf converted to [ 0xc3 0x9f ]
0x6c34 converted to [ 0xe6 0xb0 0xb4 ]
0x1f34c converted to [ 0xf0 0x9f 0x8d 0x8c ]

См. также