std::codecvt_mode

 

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>
enum codecvt_mode {     consume_header = 4,     generate_header = 2,     little_endian = 1 };		(seit C++11) (veraltet in C++17) (entfernt in C++26)

Die Facetten std::codecvt_utf8, std::codecvt_utf16 und std::codecvt_utf8_utf16 akzeptieren einen optionalen Wert vom Typ std::codecvt_mode als Template-Argument, der optionale Features der Unicode-String-Konvertierung spezifiziert.

Konstanten

Definiert in Header <locale>
Wert	Bedeutung
little_endian	nimmt an, dass die Eingabe in Little-Endian-Byte-Reihenfolge vorliegt (gilt nur für UTF-16-Eingabe, der Standard ist Big-Endian)
consume_header	konsumiert das Byte Order Mark (BOM), falls vorhanden am Anfang der Eingabesequenz, und (im Falle von UTF-16) verlässt sich auf die Byte-Reihenfolge, die es für die Dekodierung des Rests der Eingabe spezifiziert
generate_header	gibt das Byte Order Mark am Anfang der Ausgabesequenz aus

Die anerkannten Byte Order Marks sind

0xfe 0xff	UTF-16 Big-Endian
0xff 0xfe	UTF-16 Little-Endian
0xef 0xbb 0xbf	UTF-8 (keine Auswirkung auf die Endianness)

Wenn std::consume_header beim Lesen einer Datei, die mit einem Byte Order Mark beginnt, nicht ausgewählt ist, wird das Unicode-Zeichen U+FEFF (Zero width non-breaking space) als erstes Zeichen des String-Inhalts gelesen.

Beispiel

Das folgende Beispiel demonstriert den Verbrauch des UTF-8 BOM

Führen Sie diesen Code aus

#include <codecvt>
#include <cwchar>
#include <fstream>
#include <iostream>
#include <locale>
#include <string>
 
int main()
{
    // UTF-8 data with BOM
    std::ofstream{"text.txt"} << "\ufeffz\u6c34\U0001d10b";
 
    // read the UTF-8 file, skipping the BOM
    std::wifstream fin{"text.txt"};
    fin.imbue(std::locale(fin.getloc(),
                          new std::codecvt_utf8<wchar_t, 0x10ffff, std::consume_header>));
 
    for (wchar_t c; fin.get(c);)
        std::cout << std::hex << std::showbase << (std::wint_t)c << '\n';
}

Ausgabe

0x7a
0x6c34
0x1d10b

Siehe auch

codecvt	konvertiert zwischen Zeichenkodierungen, einschließlich UTF-8, UTF-16, UTF-32 (Klassentemplate)
codecvt_utf8 (C++11)(deprecated in C++17)(removed in C++26)	konvertiert zwischen UTF-8 und UCS-2/UCS-4 (Klassentemplate)
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)