std::wstring_convert

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Textverarbeitungsbibliothek

Lokalisierungsbibliothek

Reguläre Ausdrücke-Bibliothek (C++11)

Formatierungsbibliothek (C++20)

Dienstprogramme für Null-terminierte Sequenzen

Byte-Zeichenketten

Multibyte-Zeichenketten

Wide-Zeichenketten

Primitive numerische Konvertierungen

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

Textkodierungserkennung

text_encoding (C++26)

 

Lokalisierungsbibliothek

Lokale und Facetten   Lokale has_facet use_facet locale Facet-Kategorie Basisklassen ctype_base codecvt_base messages_base time_base money_base ctype-Facetten ctype ctype<char> ctype_byname codecvt codecvt_byname numerische Facetten num_get num_put numpunct numpunct_byname Kollationsfacetten collate collate_byname Zeitfacetten time_get time_put time_get_byname time_put_byname

Geldfacetten money_get money_put moneypunct moneypunct_byname Nachrichtenfacetten messages messages_byname Zeichenklassifizierung und -konvertierung Zeichenklassifizierung isspace    iscntrl isupper islower    isalpha ispunct isdigit    isxdigit isalnum isblank (C++11) isprint isgraph Zeichenkonvertierungen toupper    tolower String- und Streamkonvertierungen wstring_convert (C++11/17/26*) wbuffer_convert (C++11/17/26*) Unicode-Konvertierungsfacets codecvt_utf8 (C++11/17/26*) codecvt_utf16 (C++11/17/26*) codecvt_utf8_utf16 (C++11/17/26*) codecvt_mode (C++11/17/26*) C-Bibliotheks-Lokalisierungen LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME    setlocale localeconv lconv

 

std::wstring_convert

Memberfunktionen

wstring_convert::wstring_convert

wstring_convert::~wstring_convert

wstring_convert::from_bytes

wstring_convert::to_bytes

wstring_convert::converted

wstring_convert::state

 

Definiert in Header <locale>
template<     class Codecvt,     class Elem = wchar_t,     class Wide_alloc = std::allocator<Elem>,     class Byte_alloc = std::allocator<char> > class wstring_convert;		(seit C++11) (veraltet in C++17) (entfernt in C++26)

Die Klasse std::wstring_convert führt Konvertierungen zwischen Byte-Strings (std::string) und Wide-Strings (std::basic_string<Elem>) durch und verwendet dabei eine individuelle Codekonvertierungs-Facet (Codecvt). std::wstring_convert übernimmt den Besitz der Konvertierungs-Facet und kann keine Facette verwenden, die von einer Locale verwaltet wird.

Die standardmäßigen Facetten, die für die Verwendung mit std::wstring_convert geeignet sind, sind std::codecvt_utf8 für UTF-8/UCS-2- und UTF-8/UCS-4-Konvertierungen und std::codecvt_utf8_utf16 für UTF-8/UTF-16-Konvertierungen.

Verschachtelte Typen

Typ	Definition
byte_string	std::basic_string<char, std::char_traits<char>, Byte_alloc>
wide_string	std::basic_string<Elem, std::char_traits<Elem>, Wide_alloc>
state_type	typename Codecvt::state_type
int_type	typename wide_string::traits_type::int_type

Datenmember

Mitglied	Beschreibung
byte_string byte_err_string	der Byte-String, der bei Fehlern angezeigt werden soll ((exposition-only member object*)
wide_string wide_err_string	der Wide-String, der bei Fehlern angezeigt werden soll ((exposition-only member object*)
Codecvt* cvtptr	ein Zeiger auf das allokierte Konvertierungsobjekt ((exposition-only member object*)
state_type cvtstate	das Konvertierungszustandsobjekt ((exposition-only member object*)
std::size_t cvtcount	die Konvertierungsanzahl ((exposition-only member object*)

Member-Funktionen

(Konstruktor)	konstruiert ein neues wstring_convert (public member function)
operator=	der Copy-Assignment-Operator ist gelöscht (öffentliche Memberfunktion)
(Destruktor)	destruiert das wstring_convert und seine Konvertierungs-Facet (public member function)
from_bytes	konvertiert einen Byte-String in einen Wide-String (public member function)
to_bytes	konvertiert einen Wide-String in einen Byte-String (public member function)
converted	gibt die Anzahl der erfolgreich konvertierten Zeichen zurück (public member function)
state	gibt den aktuellen Konvertierungszustand zurück (public member function)

Siehe auch

Zeichen Konvertierungen	lokal definierte Multibyte-Zeichen (UTF-8, GB18030)	UTF-8	UTF-16
UTF-16	mbrtoc16 / c16rtomb (mit C11 DR488)	codecvt<char16_t,char,mbstate_t> codecvt_utf8_utf16<char16_t> codecvt_utf8_utf16<char32_t> codecvt_utf8_utf16<wchar_t>	N/A
UCS-2	c16rtomb (ohne C11 DR488)	codecvt_utf8<char16_t>	codecvt_utf16<char16_t>
UTF-32	mbrtoc32 / c32rtomb	codecvt<char32_t,char,mbstate_t> codecvt_utf8<char32_t>	codecvt_utf16<char32_t>
System wchar_t UTF-32 (non-Windows) UCS-2 (Windows)	mbsrtowcs / wcsrtombs use_facet<codecvt <wchar_t,char,mbstate_t>>(locale)	codecvt_utf8<wchar_t>	codecvt_utf16<wchar_t>

wbuffer_convert (C++11)(deprecated in C++17)(removed in C++26)	führt Konvertierungen zwischen einem Byte-Stream-Puffer und einem Wide-Stream-Puffer durch (Klassentemplate)
codecvt_utf8 (C++11)(deprecated in C++17)(removed in C++26)	konvertiert zwischen UTF-8 und UCS-2/UCS-4 (Klassentemplate)
codecvt_utf8_utf16 (C++11)(deprecated in C++17)(removed in C++26)	konvertiert zwischen UTF-8 und UTF-16 (Klassentemplate)