Namespaces
Variants

std:: codecvt_utf8

From cppreference.net
C++
Text processing library
Localization library
Definiert im 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 ein std::codecvt -Facet, das die Konvertierung zwischen einer UTF-8-kodierten Bytezeichenkette und einer UCS-2- oder UTF-32-Zeichenkette kapselt (abhängig vom Typ von Elem ). Dieses std::codecvt -Facet kann zum Lesen und Schreiben von UTF-8-Dateien verwendet werden, sowohl Text- als auch Binärdateien.

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

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 eine neue codecvt_utf8 Facette
(öffentliche Elementfunktion)
(Destruktor)
zerstört eine codecvt_utf8 Facette
(öffentliche Elementfunktion)

std::codecvt_utf8:: codecvt_utf8

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

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

Parameter

refs - die Anzahl der Referenzen, die mit der Facette verknüpft sind

std::codecvt_utf8:: ~codecvt_utf8

~codecvt_utf8 ( ) ;

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

ruft do_out auf
(öffentliche Elementfunktion von std::codecvt<InternT,ExternT,StateT> )
ruft do_in auf
(öffentliche Elementfunktion von std::codecvt<InternT,ExternT,StateT> )
ruft do_unshift auf
(öffentliche Elementfunktion von std::codecvt<InternT,ExternT,StateT> )
ruft do_encoding auf
(öffentliche Elementfunktion von std::codecvt<InternT,ExternT,StateT> )
ruft do_always_noconv auf
(öffentliche Elementfunktion von std::codecvt<InternT,ExternT,StateT> )
ruft do_length auf
(öffentliche Elementfunktion von std::codecvt<InternT,ExternT,StateT> )
ruft do_max_length auf
(öffentliche Elementfunktion von std::codecvt<InternT,ExternT,StateT> )

Geschützte Memberfunktionen

[virtual]
konvertiert eine Zeichenkette von InternT zu ExternT , beispielsweise beim Schreiben in eine Datei
(geschützte virtuelle Elementfunktion von std::codecvt<InternT,ExternT,StateT> )
[virtual]
konvertiert eine Zeichenkette von ExternT zu InternT , beispielsweise beim Lesen aus einer Datei
(geschützte virtuelle Elementfunktion von std::codecvt<InternT,ExternT,StateT> )
[virtual]
erzeugt die Abschlusszeichenfolge von ExternT -Zeichen für unvollständige Konvertierung
(geschützte virtuelle Elementfunktion von std::codecvt<InternT,ExternT,StateT> )
[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> )
[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> )
[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> )
[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

Hinweise

Obwohl der Standard vorschreibt, dass diese Facette mit UCS-2 arbeitet, wenn die Größe von Elem 16 Bits 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 demonstriert 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.

Diesen Code ausführen 
#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 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 >
konvertiert zwischen Zeichenkodierungen, einschließlich UTF-8, UTF-16, UTF-32
(Klassentemplate)
(C++11) (deprecated in C++17) (removed in C++26)
Tags zur Verhaltensänderung der standard codecvt Facetten
(Enumeration)
(C++11) (deprecated in C++17) (removed in C++26)
konvertiert zwischen UTF-16 und UCS-2/UCS-4
(Klassentemplate)
(C++11) (deprecated in C++17) (removed in C++26)
konvertiert zwischen UTF-8 und UTF-16
(Klassentemplate)