std::wcstombs

std::size_t wcstombs( char* dst, const wchar_t* src, std::size_t len );

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

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

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

Примечания

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

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

Параметры

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

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

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

Пример

#include <clocale>
#include <cstdlib>
#include <iostream>

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ß水𝄋"
    char mbstr[11];
    std::wcstombs(mbstr, wstr, 11);
    std::cout << "multibyte string: " << mbstr << '\n';
}

multibyte string: zß水𝄋

См. также