Namespaces
Variants

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

From cppreference.net
C++
Text processing library
Localization library
std::ctype
Definido en el encabezado <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) Función miembro pública, llama a la función miembro virtual protegida correspondiente do_widen sobrecargada de la clase más derivada. La sobrecarga (1) llama a do_widen ( c ) , la sobrecarga (2) llama a do_widen ( beg, end, dst ) .
3) Convierte el carácter de un solo byte c a la representación de carácter ancho correspondiente utilizando la transformación más simple razonable. Normalmente, esto se aplica solo a los caracteres cuya codificación multibyte es de un solo byte (por ejemplo, U+0000-U+007F en UTF-8).
4) Para cada carácter en el arreglo de caracteres [ beg , end ) , escribe el carácter ampliado correspondiente a las ubicaciones sucesivas en el arreglo de caracteres apuntado por dst .

El ensanchamiento siempre retorna un carácter ancho, pero solo los caracteres del conjunto básico de caracteres fuente (hasta C++23) conjunto básico de caracteres (desde C++23) están garantizados de tener una transformación de ensanchamiento única y bien definida, que también está garantizada de ser reversible (mediante narrow() ). En la práctica, todos los caracteres cuya representación multibyte es un solo byte usualmente se ensanchan a sus contrapartes de carácter ancho, y el resto de los valores posibles de un solo byte usualmente se mapean al mismo valor de marcador de posición, típicamente CharT ( - 1 ) .

La ampliación, si tiene éxito, preserva todas las categorías de clasificación de caracteres conocidas por is() .

Contenidos

Parámetros

c - carácter a convertir
dflt - valor predeterminado a producir si la conversión falla
beg - puntero al primer carácter en un array de caracteres a convertir
end - puntero una posición después del final para el array de caracteres a convertir
dst - puntero al primer elemento del array de caracteres a llenar

Valor de retorno

1,3) Carácter ampliado.
2,4) end

Ejemplo

Ejecutar este código 
#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'); 
}

Salida posible: 

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

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares publicados anteriormente de C++.

DR Aplicado a Comportamiento publicado Comportamiento correcto
LWG 153 C++98 widen siempre llamaba a la sobrecarga (4) llama a la sobrecarga correspondiente

Véase también

invoca do_narrow
(función miembro pública)
amplía caracteres
(función miembro pública de std::basic_ios<CharT,Traits> )
amplía un carácter estrecho de un solo byte a carácter ancho, si es posible
(función)