std::mbstowcs

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

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

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

[править] Примечание

В большинстве реализаций эта функция обновляет глобальный статический объект типа std::mbstate_t по мере обработки строки и не может быть вызвана одновременно двумя потоками, std::mbsrtowcs должна использоваться в таких случаях.

POSIX определяет общее расширение: если dst является нулевым указателем, эта функция возвращает количество широких символов, которые будут записаны в dst при преобразовании. Аналогичное поведение является стандартным для std::mbsrtowcs.

[править] Параметры

[править] Возвращаемое значение

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

При ошибке преобразования (если обнаружен недопустимый многобайтовый символ) возвращает static_cast<std::size_t> (-1).

[править] Пример

#include <iostream>
#include <clocale>
#include <cstdlib>
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    std::wcout.imbue(std::locale("en_US.utf8"));
    const char* mbstr = "z\u00df\u6c34\U0001f34c"; // или u8"zß水🍌"
                        // или "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9f\x8d\x8c";
    wchar_t wstr[5];
    std::mbstowcs(wstr, mbstr, 5);
    std::wcout << "широкая строка: " << wstr << '\n';
}

широкая строка: zß水🍌

[править] Смотрите также