std::codecvt_utf8

 

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

 

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

std::codecvt_utf8 ist eine std::codecvt Facette, die die Konvertierung zwischen einer UTF-8-kodierten Byte-Zeichenkette und einer UCS-2- oder UTF-32-Zeichenkette (abhängig vom Typ von Elem) kapselt. Diese std::codecvt Facette kann zum Lesen und Schreiben von UTF-8-Dateien verwendet werden, sowohl Text- als auch Binärdateien.

UCS-2 ist eine archaische Kodierung, die eine Teilmenge von UTF-16 ist und nur Skalarwerte im Bereich U+0000-U+FFFF (Basic Multilingual Plane) kodiert.

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

Member-Funktionen

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

std::codecvt_utf8::codecvt_utf8

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

Erstellt eine neue std::codecvt_utf8 Facette und übergibt den anfänglichen Referenzzähler refs an die Basisklasse.

Parameter

refs

-

die Anzahl der Referenzen, die auf die Facettenklasse verweisen

std::codecvt_utf8::~codecvt_utf8

~codecvt_utf8();

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

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>)
in	ruft do_in auf (public member function of std::codecvt<InternT,ExternT,StateT>)
unshift	ruft do_unshift auf (public member function of std::codecvt<InternT,ExternT,StateT>)
encoding	ruft do_encoding auf (public member function of std::codecvt<InternT,ExternT,StateT>)
always_noconv	ruft do_always_noconv auf (public member function of std::codecvt<InternT,ExternT,StateT>)
length	ruft do_length auf (public member function of std::codecvt<InternT,ExternT,StateT>)
max_length	ruft do_max_length auf (public member function of std::codecvt<InternT,ExternT,StateT>)

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>)
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>)
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>)
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>)
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>)
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>)
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>)

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.

Hinweise

Obwohl der Standard verlangt, dass diese Facette mit UCS-2 funktioniert, wenn die Größe von Elem 16 Bit beträgt, verwenden einige Implementierungen stattdessen UTF-16. Der Begriff "UCS-2" wurde als veraltet eingestuft und aus ISO 10646 entfernt.

Beispiel

Das folgende Beispiel zeigt den Unterschied zwischen UCS-2/UTF-8- und UTF-16/UTF-8-Konvertierungen: das dritte Zeichen in der Zeichenkette ist kein gültiges UCS-2-Zeichen.

Führen Sie diesen Code aus

#include <codecvt>
#include <cstdint>
#include <iostream>
#include <locale>
#include <string>
 
int main()
{
    // UTF-8 data. The character U+1d10b, musical sign segno, does not fit in UCS-2
    std::string utf8 = "z\u6c34\U0001d10b";
 
    // the UTF-8 / UTF-16 standard conversion facet
    std::wstring_convert<std::codecvt_utf8_utf16<char16_t>, char16_t> utf16conv;
    std::u16string utf16 = utf16conv.from_bytes(utf8);
    std::cout << "UTF-16 conversion produced " << utf16.size() << " code units:\n"
              << std::showbase << std::hex;
    for (char16_t c : utf16)
        std::cout << static_cast<std::uint16_t>(c) << ' ';
 
    // the UTF-8 / UCS-2 standard conversion facet
    std::wstring_convert<std::codecvt_utf8<char16_t>, char16_t> ucs2conv;
    try
    {
        std::u16string ucs2 = ucs2conv.from_bytes(utf8);
    }
    catch(const std::range_error& e)
    {
        std::u16string ucs2 = ucs2conv.from_bytes(utf8.substr(0, ucs2conv.converted()));
        std::cout << "\nUCS-2 failed after producing " << std::dec << ucs2.size()
                  << " characters:\n" << std::showbase << std::hex;
        for (char16_t c : ucs2)
            std::cout << static_cast<std::uint16_t>(c) << ' ';
        std::cout << '\n';
    }
}

Ausgabe

UTF-16 conversion produced 4 code units:
0x7a 0x6c34 0xd834 0xdd0b
UCS-2 failed after producing 2 characters:
0x7a 0x6c34

Fehlerberichte

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

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)
codecvt_mode (C++11)(deprecated in C++17)(removed in C++26)	Tags zur Änderung des Verhaltens der Standard-Codecvt-Facetten (Enum)
codecvt_utf16 (C++11)(deprecated in C++17)(removed in C++26)	konvertiert zwischen UTF-16 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)