std::mbsrtowcs

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

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

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

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

Параметры

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

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

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

Примечания

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

Пример

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

void print_as_wide(const char* mbstr)
{
    std::mbstate_t state = std::mbstate_t();
    std::size_t len = 1 + std::mbsrtowcs(nullptr, &mbstr, 0, &state);
    std::vector<wchar_t> wstr(len);
    std::mbsrtowcs(&wstr[0], &mbstr, wstr.size(), &state);
    std::wcout << "Wide string: " << &wstr[0] << '\n'
               << "The length, including '\\0': " << wstr.size() << '\n';
}

int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    const char* mbstr = "z\u00df\u6c34\U0001f34c"; // or u8"zß水🍌"
    print_as_wide(mbstr);
}

Wide string: zß水🍌
The length, including '\0': 5

См. также