std::wcsrtombs

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Строки

Строки с завершающим нулём

Однобайтовые строки

Многобайтовые строки

Широкие строки

Классы

basic_string

basic_string_view (C++17)

char_traits

 

Многобайтовые строки с завершающим нулём

Широкие/многобайтовые преобразования
mbsinit
mbtowc mbstowcs btowc mbrtowc mbsrtowcs mbrtoc8 (C++20) mbrtoc16 (C++11) mbrtoc32 (C++11)     mblen	wctomb wcstombs wctob wcrtomb wcsrtombs c8rtomb (C++20) c16rtomb (C++11) c32rtomb (C++11) mbrlen
Типы
mbstate_t

 

<tbody> </tbody>

Определено в заголовочном файле <cwchar>
std::size_t wcsrtombs( char* dst, const wchar_t** src, std::size_t len, std::mbstate_t* ps );

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

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

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

Параметры

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

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

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

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

Пример

Запустить этот код

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

void print_wide(const wchar_t* wstr)
{
    std::mbstate_t state = std::mbstate_t();
    std::size_t len = 1 + std::wcsrtombs(nullptr, &wstr, 0, &state);
    std::vector<char> mbstr(len);
    std::wcsrtombs(&mbstr[0], &wstr, mbstr.size(), &state);
    std::cout << "многобайтовая строка: " << &mbstr[0] << '\n'
              << "Длина, включая '\\0': " << mbstr.size() << '\n';
}

int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    // Узкая многобайтовая кодировка UTF-8
    const wchar_t* wstr = L"z\u00df\u6c34\U0001d10b"; // или L"zß水𝄋"
    print_wide(wstr);
}

Вывод:

многобайтовая строка: zß水𝄋
Длина, включая '\0': 11

Смотрите также

wcrtomb	преобразует широкий символ в его многобайтовое представление при заданном состоянии (функция)
mbsrtowcs	преобразует узкую многобайтовую строку символов в широкую строку при заданном состоянии (функция)
do_out [virtual]	преобразует строку из internT в externT, например, при записи в файл Оригинал: converts a string from internT to externT, such as when writing to file Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (virtual protected std::codecvt функция-элемент)
Документация C по wcsrtombs