std::wcsrtombs

std::size_t wcsrtombs( char* dst,
                       const wchar_t** src,
                       std::size_t len,
                       std::mbstate_t* ps );

Преобразует последовательность широких символов из массива, первый элемент которого указывает *src, в узкое многобайтовое представление, преобразование которого начинается в состоянии, описанном *ps. Если dst не равен null, преобразованные символы сохраняются в последовательных элементах массива char, на который указывает dst. В массив назначения записывается не более len байтов.

Каждый символ преобразуется, как если бы был выполнен вызов std::wcrtomb. Преобразование прекращается, если:

• Нулевой символ был преобразован и сохранён. src устанавливается в нулевой указатель, а *ps представляет начальное состояние сдвига.
• Обнаружен wchar_t, которому не соответствует допустимый символ в текущей локали C. src устанавливается так, чтобы указывать на первый непреобразованный широкий символ.
• Следующий многобайтовый символ, который нужно сохранить, превысит len. src устанавливается так, чтобы указывать на первый непреобразованный широкий символ. Это условие не проверяется, если dst является нулевым указателем.

Параметры

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

В случае успеха возвращает количество байтов (включая любые последовательности сдвига, но не включая завершающий '\0'), записанных в массив символов, на первый элемент которого указывает dst. Если dst является нулевым указателем, возвращает количество байтов, которое было бы записано (также не включая завершающий нулевой символ '\0').

В случае ошибки преобразования (если обнаружен недопустимый широкий символ) возвращает static_cast<std::size_t>(-1), сохраняет EILSEQ в errno и оставляет *ps в неопределённом состоянии.

Пример

#include <clocale>
#include <cwchar>
#include <iostream>
#include <string>
#include <vector>

void print_wide(const wchar_t* wstr)
{
    std::mbstate_t state = std::mbstate_t();
    std::size_t len = 1 + std::wcsrtombs(nullptr, &wstr, 0, &state);
    std::vector<char> mbstr(len);
    std::wcsrtombs(&mbstr[0], &wstr, mbstr.size(), &state);
    std::cout << "multibyte string: " << &mbstr[0] << '\n'
              << "Length, including '\\0': " << mbstr.size() << '\n';
}

int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    // UTF-8 narrow multibyte encoding
    const wchar_t* wstr = L"z\u00df\u6c34\U0001d10b"; // or L"zß水𝄋"
    print_wide(wstr);
}

multibyte string: zß水𝄋
Length, including '\0': 11

См. также