basic_streambuf::pbackfail
Une fonction membre virtuelle protégée qui tente de remettre un élément dans le flux d'entrée, puis fait de lui l'élément actuel (référencé par le prochain pointeur).
virtual int_type pbackfail(
int_type _Meta = traits_type::eof( )
);
Paramètres
- _Meta
Caractère à insérer dans la mémoire tampon, ou traits_type::EOF.
Valeur de retour
Si la fonction n'aboutit pas, elle retourne traits_type::eof ou lève une exception. Sinon, elle retourne une autre valeur. Par défaut elle retourne traits_type::eof.
Notes
Si _Meta est égal à traits_type::eof, l'élément à renvoyer est effectivement celui qui est déjà dans le flux de données avant l'élément actuel. Sinon, cet élément est remplacé par traits_type::to_char_type(_Meta). La fonction peut réactiver un élément de différentes manières :
Si une position de putback est disponible, elle peut enregistrer l'élément dans la position de putback et décrémenter le prochain pointeur du tampon d'entrée.
Elle peut rendre une position de putback disponible en allouant un stockage nouveau ou supplémentaire pour le tampon d'entrée.
Pour une mémoire tampon du flux avec flux d'entrée et de sortie communs, elle peut rendre une position de putback disponible en écrivant, vers une destination externe, certains ou tous les éléments entre les pointeurs de début et le pointeur suivant pour le tampon de sortie.
Configuration requise
En-tête: <streambuf>
Espace de noms : std