std::wcstombs

Преобразует последовательность широких символов из массива, на первый элемент которого указывает src, в его узкое многобайтовое представление, которое начинается в начальном состоянии сдвига. Преобразованные символы сохраняются в последовательных элементах массива символов, на который указывает 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 <iostream>
#include <clocale>
#include <cstdlib>
 
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    // Узкая многобайтовая кодировка UTF-8
    const wchar_t* wstr = L"z\u00df\u6c34\U0001d10b"; // или L"zß水𝄋"
    char mbstr[11];
    std::wcstombs(mbstr, wstr, 11);
    std::cout << "многобайтовая строка: " << mbstr << '\n';
}

многобайтовая строка: zß水𝄋

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