Namespaces
Variants

std:: ostreambuf_iterator

From cppreference.net
C++
Iterator library
Iterator concepts
Iterator primitives
Algorithm concepts and utilities
Indirect callable concepts
Common algorithm requirements
(C++20)
(C++20)
(C++20)
Utilities
(C++20)
Iterator adaptors
Range access
(C++11) (C++14)
(C++14) (C++14)
(C++11) (C++14)
(C++14) (C++14)
(C++17) (C++20)
(C++17)
(C++17)
std::ostreambuf_iterator
Défini dans l'en-tête <iterator>
template < class CharT, class Traits = std:: char_traits < CharT > >

class ostreambuf_iterator

: public std:: iterator < std:: output_iterator_tag , void , void , void , void >
(jusqu'à C++17)
template < class CharT, class Traits = std:: char_traits < CharT > >
class ostreambuf_iterator ;
(depuis C++17)

std::ostreambuf_iterator est un LegacyOutputIterator à passage unique qui écrit des caractères successifs dans l'objet std::basic_streambuf pour lequel il a été construit. L'opération d'écriture effective est réalisée lorsque l'itérateur (qu'il soit déréférencé ou non) est assigné. L'incrémentation du std::ostreambuf_iterator est une opération sans effet.

Dans une implémentation typique, les seuls membres de données de std::ostreambuf_iterator sont un pointeur vers le std::basic_streambuf associé et un indicateur booléen signalant si la condition de fin de fichier a été atteinte.

Table des matières

Types membres

Type de membre Définition
iterator_category std:: output_iterator_tag
value_type void
difference_type

void

(jusqu'en C++20)

std::ptrdiff_t

(depuis C++20)
pointer void
reference void
char_type CharT
traits_type Traits
streambuf_type std:: basic_streambuf < CharT, Traits >
ostream_type std:: basic_ostream < CharT, Traits >

Les types membres iterator_category , value_type , difference_type , pointer et reference doivent être obtenus en héritant de std:: iterator < std:: output_iterator_tag , void , void , void , void > .

(jusqu'à C++17)

Fonctions membres

construit un nouveau ostreambuf_iterator
(fonction membre publique)
(destructeur)
(déclaré implicitement)
détruit un ostreambuf_iterator
(fonction membre publique)
écrit un caractère dans la séquence de sortie associée
(fonction membre publique)
opération nulle
(fonction membre publique)
opération nulle
(fonction membre publique)
vérifie si la sortie a échoué
(fonction membre publique)

Exemple

Exécuter ce code 
#include <algorithm>
#include <iostream>
#include <iterator>
#include <string>
int main()
{
    std::string s = "This is an example\n";
    std::copy(s.begin(), s.end(), std::ostreambuf_iterator<char>(std::cout));
}

Sortie : 

This is an example

Voir aussi

itérateur d'entrée qui lit depuis std::basic_streambuf
(modèle de classe)
itérateur de sortie qui écrit vers std::basic_ostream
(modèle de classe)