codecvt::do_in

Artikel
06/09/2015

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

virtual result do_in(
    StateType& _State,
    const Byte* _First1, 
    const Byte* _Last1, 
    const Byte*& _Next1,
    CharType* _First2,
    CharType* _Last2,
    CharType*& _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
Zeiger zum Ende der konvertierten Sequenz, zum ersten ohne Zeichen sind.
_First2
Zeiger zum Anfang der konvertierten Sequenz.
_Last2
Zeiger zum Ende der konvertierten Sequenz.
_Next2
Zeiger auf CharType, der hinter letzte konvertierte CharType, z unveränderten ersten Zeichen in der Zielsequenz stammt.

Rückgabewert

Durch Rückgabe, die den Erfolg, partiellem Erfolg oder Fehlschlagen des Vorgangs angibt. 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 in, die do_in aufruft.

Anforderungen

Gebietsschema Header: <>

Namespace: std

Siehe auch

Referenz

codecvt-Klasse

Freigeben über