std::btowc

 

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

 

Определено в заголовочном файле <cwchar>
std::wint_t btowc( int c );

Расширяет однобайтовый символ c до эквивалентного широкого символа.

Большинство кодировок многобайтовых символов используют однобайтовые коды для представления символов из набора символов ASCII. Эту функцию можно использовать для преобразования таких символов в wchar_t.

Параметры

c

—

однобайтовый символ для расширения

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

WEOF, если c равно EOF.

Представление расширенного символа c, если (unsigned char)c является допустимым однобайтовым символом в исходном состоянии сдвига, WEOF иначе.

Пример

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

#include <clocale>
#include <cwchar>
#include <iostream>
 
void try_widen(char c)
{
    std::wint_t w = std::btowc(c);
    if (w != WEOF)
        std::cout << "Однобайтовый символ " << +(unsigned char)c
                  << " расширяется до " << +w << '\n';
    else
        std::cout << "Однобайтовый символ " << +(unsigned char)c
                  << " не удалось расширить\n";
}
 
int main()
{
    std::setlocale(LC_ALL, "lt_LT.iso88594");
    std::cout << std::hex << std::showbase << "В литовской локали ISO-8859-4:\n";
    try_widen('A');
    try_widen('\xdf'); // Немецкая буква ß (U+00df) в ISO-8859-4
    try_widen('\xf9'); // Литовская буква ų (U+0173) в ISO-8859-4
 
    std::setlocale(LC_ALL, "lt_LT.utf8");
    std::cout << "В литовской локали UTF-8:\n";
    try_widen('A');
    try_widen('\xdf');
    try_widen('\xf9');
}

Возможный вывод:

В литовской локали ISO-8859-4:
Однобайтовый символ 0x41 расширяется до 0x41
Однобайтовый символ 0xdf расширяется до 0xdf
Однобайтовый символ 0xf9 расширяется до 0x173
В литовской локали UTF-8:
Однобайтовый символ 0x41 расширяется до 0x41
Однобайтовый символ 0xdf не удалось расширить
Однобайтовый символ 0xf9 не удалось расширить

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

wctob	сужает широкий символ до однобайтового узкого символа, если это возможно (функция)
do_widen [virtual]	преобразует символ или символы из char в charT Оригинал: converts a character or characters from char to charT Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (virtual protected std::ctype функция-элемент)
Документация C по btowc