cppreference.net

Namespaces

Page

Variants

std:: codecvt_utf8_utf16

From cppreference.net

< cpp ‎ | locale

Definiert im Header `<codecvt>`
template < class Elem, unsigned long Maxcode = 0x10ffff , std:: codecvt_mode Mode = ( std:: codecvt_mode ) 0 > class codecvt_utf8_utf16 : public std:: codecvt < Elem, char , std:: mbstate_t > ;		(seit C++11) (veraltet in C++17) (entfernt in C++26)

std::codecvt_utf8_utf16 ist ein std::codecvt Facet, das die Konvertierung zwischen einer UTF-8-kodierten Bytezeichenkette und einer UTF-16-kodierten Zeichenkette kapselt. Wenn Elem ein 32-Bit-Typ ist, wird eine UTF-16-Codeeinheit in jedem 32-Bit-Zeichen der Ausgabesequenz gespeichert.

Dies ist eine N:M-Umwandlungsfacette und kann nicht mit std::basic_filebuf verwendet werden (welches nur 1:N-Umwandlungen, wie UTF-32/UTF-8, zwischen internen und externen Kodierungen erlaubt). Diese Facette kann mit std::wstring_convert verwendet werden.

Inhaltsverzeichnis

Template-Parameter

Elem	-	entweder char16_t , char32_t oder wchar_t
Maxcode	-	der größte Wert von `Elem` , den diese Facette ohne Fehler lesen oder schreiben wird
Mode	-	eine Konstante vom Typ std::codecvt_mode

Memberfunktionen

(Konstruktor)	konstruiert einen neuen `codecvt_utf8_utf16` Facette (öffentliche Elementfunktion)
(Destruktor)	zerstört eine `codecvt_utf8_utf16` Facette (öffentliche Elementfunktion)

std::codecvt_utf8_utf16:: codecvt_utf8_utf16

explicit codecvt_utf8_utf16 ( std:: size_t refs = 0 ) ;

Konstruiert einen neuen std::codecvt_utf8_utf16 Facette, übergibt den anfänglichen Referenzzähler refs an die Basisklasse.

Parameter

refs

-

die Anzahl der Referenzen, die auf die Facette verweisen

std::codecvt_utf8_utf16:: ~codecvt_utf8_utf16

~codecvt_utf8_utf16 ( ) ;

Zerstört das Facet. Im Gegensatz zu den vom Locale verwalteten Facets ist der Destruktor dieses Facets öffentlich.

Geerbt von std:: codecvt

Verschachtelte Typen

Typ	Definition
`intern_type`	`internT`
`extern_type`	`externT`
`state_type`	`stateT`

Datenmitglieder

Member	Beschreibung
std::locale::id `id` [static]	der Identifikator des Facets

Memberfunktionen

out	ruft `do_out` auf (öffentliche Elementfunktion von `std::codecvt<InternT,ExternT,StateT>` )
in	ruft `do_in` auf (öffentliche Elementfunktion von `std::codecvt<InternT,ExternT,StateT>` )
unshift	ruft `do_unshift` auf (öffentliche Elementfunktion von `std::codecvt<InternT,ExternT,StateT>` )
encoding	ruft `do_encoding` auf (öffentliche Elementfunktion von `std::codecvt<InternT,ExternT,StateT>` )
always_noconv	ruft `do_always_noconv` auf (öffentliche Elementfunktion von `std::codecvt<InternT,ExternT,StateT>` )
length	ruft `do_length` auf (öffentliche Elementfunktion von `std::codecvt<InternT,ExternT,StateT>` )
max_length	ruft `do_max_length` auf (öffentliche Elementfunktion von `std::codecvt<InternT,ExternT,StateT>` )

Geschützte Memberfunktionen

do_out [virtual]	konvertiert eine Zeichenkette von `InternT` zu `ExternT` , beispielsweise beim Schreiben in eine Datei (geschützte virtuelle Elementfunktion von `std::codecvt<InternT,ExternT,StateT>` )
do_in [virtual]	konvertiert eine Zeichenkette von `ExternT` zu `InternT` , beispielsweise beim Lesen aus einer Datei (geschützte virtuelle Elementfunktion von `std::codecvt<InternT,ExternT,StateT>` )
do_unshift [virtual]	erzeugt die Abschlusszeichenfolge von `ExternT` -Zeichen für unvollständige Konvertierung (geschützte virtuelle Elementfunktion von `std::codecvt<InternT,ExternT,StateT>` )
do_encoding [virtual]	gibt die Anzahl der `ExternT` -Zeichen zurück, die notwendig sind, um ein `InternT` -Zeichen zu erzeugen, falls konstant (geschützte virtuelle Elementfunktion von `std::codecvt<InternT,ExternT,StateT>` )
do_always_noconv [virtual]	prüft, ob das Facet für alle gültigen Argumentwerte eine Identitätskonvertierung durchführt (geschützte virtuelle Elementfunktion von `std::codecvt<InternT,ExternT,StateT>` )
do_length [virtual]	berechnet die Länge der `ExternT` -Zeichenkette, die durch Konvertierung in den gegebenen `InternT` -Puffer verbraucht würde (geschützte virtuelle Elementfunktion von `std::codecvt<InternT,ExternT,StateT>` )
do_max_length [virtual]	gibt die maximale Anzahl von `ExternT` -Zeichen zurück, die in ein einzelnes `InternT` -Zeichen konvertiert werden könnten (geschützte virtuelle Elementfunktion von `std::codecvt<InternT,ExternT,StateT>` )

Geerbt von std:: codecvt_base

Geschachtelter Typ	Definition
enum result { ok, partial, error, noconv } ;	Unbegrenzter Aufzählungstyp

Aufzählungskonstante	Definition
`ok`	Konversion wurde ohne Fehler abgeschlossen
`partial`	nicht alle Quellzeichen wurden konvertiert
`error`	ungültiges Zeichen angetroffen
`noconv`	keine Konversion erforderlich, Eingabe- und Ausgabetypen sind identisch

Beispiel

Diesen Code ausführen

#include <cassert>
#include <codecvt>
#include <cstdint>
#include <iostream>
#include <locale>
#include <string>
int main()
{
    std::string u8 = "z\u00df\u6c34\U0001f34c";
    std::u16string u16 = u"z\u00df\u6c34\U0001f34c";
    // UTF-8 zu UTF-16/char16_t
    std::u16string u16_conv = std::wstring_convert<
        std::codecvt_utf8_utf16<char16_t>, char16_t>{}.from_bytes(u8);
    assert(u16 == u16_conv);
    std::cout << "UTF-8 zu UTF-16 Konvertierung erzeugte " << u16_conv.size()
              << " Code-Einheiten:\n" << std::showbase << std::hex;
    for (char16_t c : u16_conv)
        std::cout << static_cast<std::uint16_t>(c) << ' ';
    // UTF-16/char16_t zu UTF-8
    std::string u8_conv = std::wstring_convert<
        std::codecvt_utf8_utf16<char16_t>, char16_t>{}.to_bytes(u16);
    assert(u8 == u8_conv);
    std::cout << "\nUTF-16 zu UTF-8 Konvertierung erzeugte "
              << std::dec << u8_conv.size() << " Bytes:\n" << std::hex;
    for (char c : u8_conv)
        std::cout << +static_cast<unsigned char>(c) << ' ';
    std::cout << '\n';
}

Ausgabe:

UTF-8 zu UTF-16 Konvertierung erzeugte 5 Code-Einheiten:
0x7a 0xdf 0x6c34 0xd83c 0xdf4c
UTF-16 zu UTF-8 Konvertierung erzeugte 10 Bytes:
0x7a 0xc3 0x9f 0xe6 0xb0 0xb4 0xf0 0x9f 0x8d 0x8c

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	Angewendet auf	Verhalten wie veröffentlicht	Korrektes Verhalten
LWG 2229	C++98	Konstruktor und Destruktor waren nicht spezifiziert	spezifiziert diese

Siehe auch

Zeichenkonvertierungen	gebietsschemadefinierte Multibyte (UTF-8, GB18030)	UTF-8	UTF-16
UTF-16	`mbrtoc16` / `c16rtomb` (mit C11's 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's 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 (nicht-Windows) UCS-2 (Windows)	`mbsrtowcs` / `wcsrtombs` `use_facet` < `codecvt` < wchar_t , char ,mbstate_t >> ( `locale` )	`codecvt_utf8` < wchar_t >	`codecvt_utf16` < wchar_t >

codecvt	konvertiert zwischen Zeichenkodierungen, einschließlich UTF-8, UTF-16, UTF-32 (Klassentemplate)
codecvt_mode (C++11) (veraltet in C++17) (entfernt in C++26)	Tags zum Ändern des Verhaltens der standard codecvt Facetten (Enumeration)
codecvt_utf8 (C++11) (veraltet in C++17) (entfernt in C++26)	konvertiert zwischen UTF-8 und UCS-2/UCS-4 (Klassentemplate)
codecvt_utf16 (C++11) (veraltet in C++17) (entfernt in C++26)	konvertiert zwischen UTF-16 und UCS-2/UCS-4 (Klassentemplate)