std::ctype<CharT>::widen, do_widen

Определён в заголовочном файле `<locale>`
public: CharT widen( char c ) const;	(1)
public: const char* widen( const char* beg, const char* end, CharT* dst ) const;	(2)
protected: virtual CharT do_widen( char c ) const;	(3)
protected: virtual const char* do_widen( const char* beg, const char* end, CharT* dst ) const;	(4)

1,2) Открытая функция-член, вызывающая соответствующую защищённую виртуальную функцию-член do_widen наиболее производного класса. Перегрузка (1) вызывает do_widen(c), перегрузка (2) вызывает do_widen(beg, end, dst).

3) Преобразует однобайтовый символ c в соответствующее представление широкого символа, используя наиболее простой разумный способ преобразования. Обычно это применяется только к символам, многобайтовое представление которых состоит из одного байта (например, U+0000-U+007F в UTF-8).

4) Для каждого символа в массиве символов [beg, end) записывает соответствующий преобразованный широкий символ в следующую позицию массива символов, на который указывает dst.

Преобразование всегда возвращает широкий символ, но только для символов из базового набора исходных символов(до C++23)базового набора символов(начиная с C++23) гарантируется уникальное и чётко определённое преобразование в широкий символ, которое также гарантированно обратимо (с помощью narrow()). На практике все символы, многобайтовое представление которых состоит из одного байта, обычно преобразуются в соответствующие широкие символы, а остальные возможные однобайтовые значения обычно отображаются в одно и то же значение-заполнитель, как правило, CharT(-1).

Если преобразование успешно, оно сохраняет все категории классификации символов, известные is().

Параметры

c	-	символ для преобразования
dflt	-	значение по умолчанию, возвращаемое при неудачном преобразовании
beg	-	указатель на первый символ массива символов для преобразования
end	-	указатель на позицию за последним символом массива символов для преобразования
dst	-	указатель на первый элемент массива символов для заполнения

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

1,3) Преобразованный широкий символ.

2,4) end

Пример

#include <iostream>
#include <locale>

void try_widen(const std::ctype<wchar_t>& f, char c)
{
    wchar_t w = f.widen(c);
    std::cout << "The single-byte character " << +(unsigned char)c
              << " widens to " << +w << '\n';
}
 
int main()
{
    std::locale::global(std::locale("cs_CZ.iso88592"));
    auto& f = std::use_facet<std::ctype<wchar_t>>(std::locale());
    std::cout << std::hex << std::showbase << "In Czech ISO-8859-2 locale:\n";
    try_widen(f, 'a');
    try_widen(f, '\xdf'); // German letter ß (U+00df) in ISO-8859-2
    try_widen(f, '\xec'); // Czech letter ě (U+011b) in ISO-8859-2
    
    std::locale::global(std::locale("cs_CZ.utf8"));
    auto& f2 = std::use_facet<std::ctype<wchar_t>>(std::locale());
    std::cout << "In Czech UTF-8 locale:\n";
    try_widen(f2, 'a');
    try_widen(f2, '\xdf'); 
    try_widen(f2, '\xec'); 
}

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

In Czech ISO-8859-2 locale:
The single-byte character 0x61 widens to 0x61
The single-byte character 0xdf widens to 0xdf
The single-byte character 0xec widens to 0x11b
In Czech UTF-8 locale:
The single-byte character 0x61 widens to 0x61
The single-byte character 0xdf widens to 0xffffffff
The single-byte character 0xec widens to 0xffffffff

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены задним числом к ранее опубликованным стандартам C++.

DR	Применяется к	Опубликованное поведение	Правильное поведение
LWG 153	C++98	`widen` всегда вызывала перегрузку (4)	вызывает соответствующую перегрузку

См. также

narrow	вызывает `do_narrow` (открытая функция-член)
widen	преобразует символы в широкие (открытая функция-член класса `std::basic_ios<CharT,Traits>`)
btowc	преобразует однобайтовый узкий символ в широкий символ, если это возможно (функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/locale/ctype/widen