std::codecvt<InternT,ExternT,StateT>:: out, do_out

Wenn diese codecvt Facette keine Konvertierung definiert, werden keine Zeichen konvertiert. to_next wird gleich to gesetzt, state bleibt unverändert und std::codecvt_base::noconv wird zurückgegeben.

do_out ( state, from, from + 1 , from_next, to, to_end, to_next ) muss ok zurückgeben, wenn

• Diese codecvt Facette wird von basic_filebuf verwendet, und
• do_out ( state, from, from_end, from_next, to, to_end, to_next ) würde ok zurückgeben, wobei from ! = from_end .

Rückgabewert

Ein Wert vom Typ std::codecvt_base::result , der den Erfolgsstatus wie folgt anzeigt:

Die nicht-konvertierende Spezialisierung std:: codecvt < char , char , std:: mbstate_t > gibt immer std::codecvt_base::noconv zurück.

Hinweise

Erfordert, dass from <= from_end && to <= to_end und dass state entweder den initialen Shift-Zustand repräsentiert oder durch Konvertierung der vorherigen Zeichen in der Sequenz erhalten wurde.

Während codecvt N:M-Konvertierungen unterstützt (z.B. UTF-16 zu UTF-8, wo zwei interne Zeichen notwendig sein können, um zu entscheiden, welche externen Zeichen ausgegeben werden sollen), std::basic_filebuf kann nur codecvt Facetten verwenden, die eine 1:N-Konvertierung definieren, das heißt es muss in der Lage sein, ein internes Zeichen nach dem anderen zu verarbeiten, wenn in eine Datei geschrieben wird.

Bei der Durchführung von N:M-Konvertierungen kann diese Funktion std::codecvt_base::partial zurückgeben, nachdem alle Quellzeichen verarbeitet wurden ( from_next == from_end ). Dies bedeutet, dass ein weiteres internes Zeichen benötigt wird, um die Konvertierung abzuschließen (z.B. bei der Konvertierung von UTF-16 zu UTF-8, wenn das letzte Zeichen im Quellpuffer ein High-Surrogate ist).

Die Auswirkung auf state ist absichtlich nicht spezifiziert. In Standard-Facets wird es verwendet, um den Shift-Zustand beizubehalten, wie beim Aufruf von std:: wcsrtombs , und wird daher aktualisiert, um den Shift-Zustand nach dem letzten erfolgreich konvertierten Zeichen widerzuspiegeln, aber eine benutzerdefinierte Facette kann es frei verwenden, um jeden anderen Zustand zu verwalten, z.B. die Anzahl der speziellen Zeichen zu zählen.

Beispiel

#include <iostream>
#include <locale>
#include <string>
int main()
{
    std::locale::global(std::locale("en_US.utf8"));
    auto& f = std::use_facet<std::codecvt<wchar_t, char, std::mbstate_t>>(std::locale());
    std::wstring internal = L"z\u00df\u6c34\U0001f34c"; // L"zß水🍌"
    // Hinweis: Das Folgende könnte auch mit wstring_convert umgesetzt werden
    std::mbstate_t mb{}; // initialer Schaltzustand
    std::string external(internal.size() * f.max_length(), '\0'); 
    const wchar_t* from_next;
    char* to_next;
    f.out(mb, &internal[0], &internal[internal.size()], from_next,
              &external[0], &external[external.size()], to_next);
    // Fehlerüberprüfung der Kürze halber ausgelassen
    external.resize(to_next - &external[0]);
    std::cout << "The string in narrow multibyte encoding: " << external << '\n';
}

The string in narrow multibyte encoding: zß水🍌

Fehlerberichte

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

Siehe auch