Freigeben über


ctype::widen

Konvertiert ein Zeichen vom Typ char in systemeigenen Zeichensatz in den entsprechenden Zeichen des Typs CharType verwendet von einem Gebietsschema.

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

Parameter

  • byte
    Das Zeichen des Typs char im systemeigenen zu konvertierende Zeichensatz.

  • first
    Ein Zeiger auf das erste Zeichen im Bereich von den zu konvertierenden Zeichen.

  • last
    Ein Zeiger auf Zeichen direkt hinter dem letzten Zeichen im Bereich von den zu konvertierenden Zeichen.

  • dest
    Ein Zeiger auf das erste Zeichen des Typs CharType im Zielbereich, der den konvertierten Bereich von Zeichen speichert.

Rückgabewert

Die erste Memberfunktion gibt den Zeichen vom Typ CharType zurück, der dem Parameterzeichen des systemeigenen Typs char entspricht.

Die zweite Memberfunktion gibt einen Zeiger dem Zielbereich von Zeichen vom Typ CharType verwendet von einem Gebietsschema zurück, das aus systemeigenen Zeichen des Typs char konvertiert wird.

Hinweise

Die erste Memberfunktion gibt do_widen zurück (byte). Die zweite Memberfunktion gibt do_widen zurück (first, last, dest).

Beispiel

// 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' );
}
  

Anforderungen

Gebietsschema Header: <>

Namespace: std

Siehe auch

Referenz

ctype-Klasse