cppreference.com

Konto erstellen

Namensräume

Seite
Diskussion

Varianten

Ansichten

Ansicht
Bearbeiten
Verlauf

Aktionen

std::codecvt_utf8_utf16

Von cppreference.com

< cpp‎ | locale

Definiert in 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 eine std::codecvt Facette, die die Konvertierung zwischen einem UTF-8-kodierten Byte-String und einem UTF-16-kodierten Zeichen-String kapselt. Wenn Elem ein 32-Bit-Typ ist, wird eine UTF-16-Code-Einheit in jedem 32-Bit-Zeichen der Ausgabesequenz gespeichert.

Dies ist eine N:M-Konvertierungsfacette und kann nicht mit std::basic_filebuf verwendet werden (welches nur 1:N-Konvertierungen, wie z.B. UTF-32/UTF-8, zwischen interner und externer Kodierung erlaubt). Diese Facette kann mit std::wstring_convert verwendet werden.

Inhalt

1 Template-Parameter
2 Member-Funktionen
3 std::codecvt_utf8_utf16::codecvt_utf8_utf16
- 3.1 Parameter
4 std::codecvt_utf8_utf16::~codecvt_utf8_utf16
5 Abgeleitet von std::codecvt
6 Geerbt von std::codecvt_base

[bearbeiten] 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

[bearbeiten] Member-Funktionen

(Konstruktor)	erstellt eine neue `codecvt_utf8_utf16` Facette (öffentliche Memberfunktion)
(Destruktor)	zerstört eine `codecvt_utf8_utf16` Facette (öffentliche Memberfunktion)

std::codecvt_utf8_utf16::codecvt_utf8_utf16

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

Erstellt eine neue std::codecvt_utf8_utf16 Facette und übergibt den initialen Referenzzähler refs an die Basisklasse.

Parameter

refs

-

die Anzahl der Referenzen, die auf die Facettenklasse verweisen

std::codecvt_utf8_utf16::~codecvt_utf8_utf16

~codecvt_utf8_utf16();

Zerstört die Facette. Im Gegensatz zu den locale-verwalteten Facetten ist der Destruktor dieser Facette öffentlich.

Abgeleitet von std::codecvt

Verschachtelte Typen

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

[edit] Datenmember

Mitglied	Beschreibung
std::locale::id `id` [static]	die Kennung des Facets

Memberfunktionen

out	ruft `do_out` auf (public member function of `std::codecvt<InternT,ExternT,StateT>`) [edit]
in	ruft `do_in` auf (public member function of `std::codecvt<InternT,ExternT,StateT>`) [edit]
unshift	ruft `do_unshift` auf (public member function of `std::codecvt<InternT,ExternT,StateT>`) [edit]
encoding	ruft `do_encoding` auf (public member function of `std::codecvt<InternT,ExternT,StateT>`) [edit]
always_noconv	ruft `do_always_noconv` auf (public member function of `std::codecvt<InternT,ExternT,StateT>`) [edit]
length	ruft `do_length` auf (public member function of `std::codecvt<InternT,ExternT,StateT>`) [edit]
max_length	ruft `do_max_length` auf (public member function of `std::codecvt<InternT,ExternT,StateT>`) [edit]

Geschützte Memberfunktionen

do_out [virtuell]	konvertiert eine Zeichenkette von `InternT` nach `ExternT`, z. B. beim Schreiben in eine Datei (virtual protected member function of `std::codecvt<InternT,ExternT,StateT>`) [edit]
do_in [virtuell]	konvertiert eine Zeichenkette von `ExternT` nach `InternT`, z. B. beim Lesen aus einer Datei (virtual protected member function of `std::codecvt<InternT,ExternT,StateT>`) [edit]
do_unshift [virtuell]	erzeugt die Abschlusszeichenfolge von `ExternT`-Zeichen für eine unvollständige Konvertierung (virtual protected member function of `std::codecvt<InternT,ExternT,StateT>`) [edit]
do_encoding [virtuell]	gibt die Anzahl der `ExternT`-Zeichen zurück, die zur Erzeugung eines `InternT`-Zeichens erforderlich sind, falls diese konstant ist (virtual protected member function of `std::codecvt<InternT,ExternT,StateT>`) [edit]
do_always_noconv [virtuell]	prüft, ob das Facet eine Identitätskonvertierung für alle gültigen Argumentwerte kodiert (virtual protected member function of `std::codecvt<InternT,ExternT,StateT>`) [edit]
do_length [virtuell]	berechnet die Länge der `ExternT`-Zeichenkette, die bei der Konvertierung in den gegebenen `InternT`-Puffer verbraucht würde (virtual protected member function of `std::codecvt<InternT,ExternT,StateT>`) [edit]
do_max_length [virtuell]	gibt die maximale Anzahl von `ExternT`-Zeichen zurück, die in ein einzelnes `InternT`-Zeichen konvertiert werden könnten (virtual protected member function of `std::codecvt<InternT,ExternT,StateT>`) [edit]

Geerbt von std::codecvt_base

Verschachtelter Typ	Definition
enum result { ok, partial, error, noconv };	Aufzählungstyp ohne Gültigkeitsbereich

Enumerationskonstante	Definition
`ok`	Die Konvertierung wurde ohne Fehler abgeschlossen.
`partiell`	Nicht alle Quellzeichen wurden konvertiert.
`error`	Ungültiges Zeichen angetroffen.
`noconv`	Keine Konvertierung erforderlich, Eingabe- und Ausgabetypen sind identisch.

[bearbeiten] Beispiel

Führen Sie diesen Code aus

#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 to 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 to UTF-16 conversion produced " << u16_conv.size()
              << " code units:\n" << std::showbase << std::hex;
    for (char16_t c : u16_conv)
        std::cout << static_cast<std::uint16_t>(c) << ' ';
 
    // UTF-16/char16_t to 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 to UTF-8 conversion produced "
              << 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 to UTF-16 conversion produced 5 code units:
0x7a 0xdf 0x6c34 0xd83c 0xdf4c
UTF-16 to UTF-8 conversion produced 10 bytes:
0x7a 0xc3 0x9f 0xe6 0xb0 0xb4 0xf0 0x9f 0x8d 0x8c

[bearbeiten] Defect Reports

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

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 2229	C++98	der Konstruktor und Destruktor waren nicht spezifiziert	spezifiziert sie

[bearbeiten] 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>

codecvt	konvertiert zwischen Zeichenkodierungen, einschließlich UTF-8, UTF-16, UTF-32 (Klassentemplate) [bearbeiten]
codecvt_mode (C++11)(deprecated in C++17)(removed in C++26)	Tags zur Änderung des Verhaltens der Standard-Codecvt-Facetten (Enum) [bearbeiten]
codecvt_utf8 (C++11)(deprecated in C++17)(removed in C++26)	konvertiert zwischen UTF-8 und UCS-2/UCS-4 (Klassentemplate) [bearbeiten]
codecvt_utf16 (C++11)(deprecated in C++17)(removed in C++26)	konvertiert zwischen UTF-16 und UCS-2/UCS-4 (Klassentemplate) [bearbeiten]

Abgerufen von "https://cppreference.de/mwiki/index.php?title=cpp/locale/codecvt_utf8_utf16&oldid=177707"