istreambuf_iterator, classe

La classe de modèle istreambuf_iterator décrit un objet d'itérateur d'entrée qui extrait des éléments de caractères depuis un tampon de flux d'entrée, auquel il accède via un objet qu'il enregistre, du pointeur de type vers basic_streambuf<CharType, Traits>.

template <  
   class CharType 
   class Traits = char_traits<CharType> 
> 
class istreambuf_iterator 
: public iterator<input_iterator_tag, CharType, typename Traits::off_type, CharType *, CharType&>

Paramètres

• CharType
  Type qui représente le type de caractère pour istreambuf_iterator.

• Traits
  Type qui représente le type de caractère pour istreambuf_iterator. Cet argument est facultatif et sa valeur par défaut est char_traits<CharType>.

Notes

La classe istreambuf_iterator doit répondre aux exigences d'un itérateur d'entrée.

Après avoir construit ou incrémenté un objet de la classe istreambuf_iterator avec un pointeur non null stocké, l'objet tente d'extraire et de stocker un objet de type CharType à partir du flux d'entrée associé. Toutefois, l'extraction peut être différée jusqu'à ce que l'objet soit déréférencé ou copié. Si l'extraction échoue, l'objet remplace le pointeur stocké par un pointeur null, créant ainsi un indicateur de fin de séquence.

Constructeurs

istreambuf_iterator

Construit un istreambuf_iterator qui est initialisé pour lire des caractères à partir du flux d'entrée.

Typedef

char_type	Type qui fournit le type de caractère de ostreambuf_iterator.
int_type	Type qui fournit un type entier pour un istreambuf_iterator.
istream_type	Type qui fournit le type de flux de istream_iterator.
streambuf_type	Type qui fournit le type de flux de istreambuf_iterator.
traits_type	Type qui fournit le type de caractéristique de istream_iterator.

Fonctions membres

equal

Vérifie l'égalité de deux itérateurs de tampon de flux d'entrée.

Opérateurs

operator*	L'opérateur de suppression de référence retourne le caractère suivant du flux.
operator++	Retourne le caractère suivant du flux d'entrée ou copie l'objet avant de l'incrémenter et de retourner sa copie.
operator->	Retourne la valeur d'un membre, le cas échéant.

Configuration requise

En-tête : <iterator>

Espace de noms : std

Voir aussi

Référence

iterator, struct

<iterator>

Sécurité des threads dans la bibliothèque standard C++

Bibliothèque STL (Standard Template Library)