std::wcrtomb
| Определено в заголовочном файле <cwchar>
|
||
std::size_t wcrtomb( char* s, wchar_t wc, std::mbstate_t* ps ); |
||
Преобразует широкий символ в его узкое многобайтовое представление.
Если s не является нулевым указателем, функция определяет количество байтов, необходимых для хранения многобайтового представления символа wc (включая любые последовательности сдвига и с учётом текущего многобайтового состояния преобразования *ps) и сохраняет представление многобайтовых символов в массиве символов, на первый элемент которого указывает s, обновляя *ps по мере необходимости. С помощью этой функции можно записать не более MB_CUR_MAX байт.
Если s является нулевым указателем, вызов эквивалентен std::wcrtomb(buf, L'\0', ps) для некоторого внутреннего буфера buf .
Если wc является нулевым широким символом L'\0', сохраняется нулевой байт, которому предшествует любая последовательность сдвига, необходимая для восстановления исходного состояния сдвига, и параметр состояния преобразования *ps обновляется для представления исходного состояния сдвига.
Параметр
| s | — | указатель на массив узких символов, в котором будет храниться многобайтовый символ |
| wc | — | широкий символ для преобразования |
| ps | — | указатель на объект состояния преобразования, используемый при интерпретации многобайтовой строки |
Возвращаемое значение
В случае успеха возвращает количество байтов (включая любые последовательности сдвигов), записанных в массив символов, на первый элемент которого указывает s.
В случае неудачи (если wc не является допустимым широким символом), возвращает static_cast<std::size_t>(-1), сохраняет EILSEQ в errno и оставляет *ps в не указанном состоянии.
Пример
#include <clocale>
#include <cwchar>
#include <iostream>
#include <string>
void print_wide(const std::wstring& wstr)
{
std::mbstate_t state{};
for (wchar_t wc : wstr)
{
std::string mb(MB_CUR_MAX, '\0');
std::size_t ret = std::wcrtomb(&mb[0], wc, &state);
std::cout << "многобайтовый символ " << mb << " занимает " << ret << " байта\n";
}
}
int main()
{
std::setlocale(LC_ALL, "en_US.utf8");
std::wstring wstr = L"z\u00df\u6c34\U0001f34c"; // или L"zß水🍌"
print_wide(wstr);
}
Вывод:
многобайтовый символ z занимает 1 байта
многобайтовый символ ß занимает 2 байта
многобайтовый символ 水 занимает 3 байта
многобайтовый символ 🍌 занимает 4 байта
Смотрите также
| преобразует широкий символ в его многобайтовое представление (функция) | |
| преобразует следующий многобайтовый символ в широкий символ при заданном состоянии (функция) | |
[virtual] |
преобразует строку из internT в externT, например, при записи в файл Оригинал: converts a string from internT to externT, such as when writing to file Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (virtual protected std::codecvt функция-элемент)
|
Документация C по wcrtomb
| |