Partager via


codecvt::do_unshift

Une fonction virtuelle appelée pour fournir Octets est nécessaire dans une conversion d'état dépendant de terminer le dernier caractère dans une séquence de OctetS.

virtual result do_unshift(
    StateType& _State,
    Byte* _First2, 
    Byte* _Last2, 
    Byte*& _Next2
) const;

Paramètres

  • _State
    Le rapport de conversion qui est mis à jour entre les appels à la fonction membre.

  • _First2
    Pointeur vers la première position dans la plage de destination.

  • _Last2
    Pointeur vers la dernière position dans la plage de destination.

  • _Next2
    Pointeur vers le premier élément inchangé dans la séquence de destination.

Valeur de retour

Les retours de fonction :

  • codecvt_base::error si le _State représente un état non valide

  • codecvt_base::noconv si la fonction n'exécute pas de conversion

  • codecvt_base::ok si la conversion réussit

  • codecvt_base::partial si la destination n'est pas suffisamment grande pour la conversion réussisse

Notes

Les tests virtuels protégés de fonction membre pour convertir l'élément source CharType(0) en une séquence de destination dans laquelle elle enregistre [_First2, _Last2), à l'exception de l'élément se terminant Octet(0).Il stocker toujours dans _Next2 un pointeur vers le premier élément inchangé dans la séquence de destination.

Le _State doit représenter le rapport de conversion initiale au début d'une séquence source.La fonction modifie sa valeur signalée si nécessaire pour refléter l'état actuel d'une conversion réussie.En général, la conversion de l'élément source CharType(0) permet l'état actuel du rapport de conversion initiale.

Exemple

Consultez l'exemple pour unshift, qui appelle do_unshift.

Configuration requise

en-tête : <locale>

l'espace de noms : DST

Voir aussi

Référence

codecvt Class