codecvt::do_out

Artikel
06/09/2015

Eine virtuelle Funktion aufgerufen, um eine Sequenz von interner CharTypes auf eine Sequenz von externem Bytes zu konvertieren.

virtual result do_out(
    StateType& _State,
    const CharType* _First1, 
    const CharType* _Last1,
    const CharType*& _Next1,
    Byte* _First2, 
    Byte* _Last2, 
    Byte*& _Next2
) const;

Parameter

_State
Der Konvertierungszustand, zwischen Aufrufen zur Memberfunktion beibehalten wird.
_First1
Zeiger zum Anfang der zu konvertierende Sequenz.
_Last1
Zeiger zum Ende der zu konvertierende Sequenz.
_Next1
Verweises auf einen Zeiger ohne CharType zum ersten, letzten nach CharType konvertierte.
_First2
Zeiger zum Anfang der konvertierten Sequenz.
_Last2
Zeiger zum Ende der konvertierten Sequenz.
_Next2
Verweises auf einen Zeiger ohne Byte zum ersten, letzten nach Byte konvertierte.

Rückgabewert

Die Funktion:

codecvt_base::error, wenn die Quellsequenz nicht ordnungsgemäß formatiert ist.
codecvt_base::noconv, wenn die Funktion keine Konvertierung ausgeführt wird.
codecvt_base::ok, wenn die Konvertierung erfolgreich ausgeführt.
codecvt_base::partial, wenn die Quelle nicht ausreicht, oder wenn das Ziel nicht groß genug ist, sodass die Konvertierung erfolgreich ausgeführt.

Hinweise

_State muss die ursprünglichen Konvertierungszustand zu Beginn einer neuer Quellsequenz darstellen. Die Funktion ändert den gespeicherten Wert nach Bedarf, um den aktuellen Zustand einer erfolgreichen Konvertierung wiederzugeben. Sein gespeicherten Wert ist andernfalls nicht angegeben.

Beispiel

Im Beispiel für out, die do_out aufruft.

Anforderungen

Gebietsschema Header: <>

Namespace: std

Siehe auch

Referenz

codecvt-Klasse

Freigeben über