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ß水𝄋

См. также