Compartilhar via


ctype::widen

Converte um caractere do tipo char no conjunto de caracteres nativo para o caractere correspondente do tipo CharType usado por uma localidade.

CharType widen(
    char byte
) const;
const char *widen(
    const char* first, 
    const char* last, 
    CharType* dest
) const;

Parâmetros

  • byte
    O caractere de caracteres do tipo no conjunto de caracteres nativo a ser convertido.

  • first
    Um ponteiro para o primeiro caractere no intervalo dos caracteres a serem convertidos.

  • last
    Um ponteiro para o caractere imediatamente depois do último caractere no intervalo dos caracteres a serem convertidos.

  • dest
    Um ponteiro para o primeiro caractere do tipo CharType no intervalo de destino que armazena o intervalo convertido de caracteres.

Valor de retorno

A primeira função de membro retorna o caractere de tipo CharType que corresponde ao caractere de parâmetro do tipo nativo char.

A segunda função de membro retorna um ponteiro para o intervalo de destino de caracteres de tipo CharType usados por uma localidade de caracteres convertida nativos do tipo char.

Comentários

A primeira função de membro retorna do_widen(byte). A segunda função de membro retorna do_widen(first, last, dest).

Exemplo

// ctype_widen.cpp
// compile with: /EHsc /W3
#include <locale>
#include <iostream>
using namespace std;

int main( )
{
   locale loc1 ( "English" );
   char *str1 = "Hello everyone!";
   wchar_t str2 [16];
   bool result1 = (use_facet<ctype<wchar_t> > ( loc1 ).widen
      ( str1, str1 + strlen(str1), &str2[0] ) != 0);  // C4996
   str2[strlen(str1)] = '\0';
   cout << str1 << endl;
   wcout << &str2[0] << endl;

   ctype<wchar_t>::char_type charT;
   charT = use_facet<ctype<char> > ( loc1 ).widen( 'a' );
}
  

Requisitos

localidade <deCabeçalho: >

Namespace: std

Consulte também

Referência

Classe ctype