Partager via


codecvt::do_in

Fonction virtuelle appelée pour convertir une séquence d'octets externes en une séquence de CharType internes.

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

Paramètres

  • _State
    L'état de conversion qui est conservé entre les appels à la méthode.

  • _First1
    Pointeur vers le début de la séquence à convertir.

  • _Last1
    Pointeur vers la fin de la séquence à convertir.

  • _Next1
    Pointeur au delà de la fin de la séquence convertie au premier caractère non-converti.

  • _First2
    Pointeur vers le début de la séquence convertie.

  • _Last2
    Pointeur vers la fin de la séquence convertie.

  • _Next2
    Pointeur vers CharType qui vient après le dernier Chartype converti en premier caractère non modifié dans la séquence de destination.

Valeur de retour

Un résultat qui indique la réussite, échec ou échec partiel de l'opération. La fonction retourne:

  • codecvt_base::error si la séquence source est mal formée.

  • codecvt_base::noconv si la fonction n'effectue aucune conversion.

  • codecvt_base::ok si la conversion réussit.

  • codecvt_base::partial si la source est insuffisante ou si la destination n'est pas assez grande pour que la conversion réussisse.

Notes

_State doit représenter l'état de conversion initial au début d'une nouvelle séquence source. La fonction remplace la valeur stockée, si nécessaire, pour refléter l'état actuel d'une conversion réussie. Sa valeur stockée n'est sinon pas spécifiée.

Exemple

Consultez l'exemple de in, qui appelle do_in.

Configuration requise

En-tête : <locale>

Espace de noms : std

Voir aussi

Référence

codecvt, classe