basic_ostream, classe

Article
06/09/2015

Cette classe du modèle décrit un objet qui contrôle l'insertion des éléments et des objets encodés dans une mémoire tampon de flux avec des éléments de type Elem, également appelés char_type, dont les caractéristiques de caractères sont déterminées par la classe Tr, également appelée traits_type.

template <class _Elem, class _Tr = char_traits<Elem> > 
   class basic_ostream 
       : virtual public basic_ios<_Elem, _Tr>

Paramètres

_Elem
char_type
_Tr
Le caractère traits_type.

Notes

La plupart des fonctions membres qui surchargent opérateur<< sont des fonctions de sortie mise en forme. Elles suivent le modèle :

   iostate state = goodbit;
   const sentry ok( *this );
   if ( ok )
      {try
         {<convert and insert elements
         accumulate flags in state> }
      catch ( ... )
         {try
           {setstate( badbit ); }
         catch ( ... )
           {}
         if ( ( exceptions( ) & badbit ) != 0 )
           throw; }}
   width( 0 );    // Except for operator<<(Elem)
   setstate( state );
   return ( *this );

Deux autres fonctions membres sont des fonctions de sortie non mises en forme. Elles suivent le modèle :

   iostate state = goodbit;
   const sentry ok( *this );
   if ( !ok )
      state |= badbit;
   else
      {try
         {<obtain and insert elements
         accumulate flags in state> }
      catch ( ... )
         {try
            {setstate( badbit ); }
         catch ( ... )
            {}
         if ( ( exceptions( ) & badbit ) != 0 )
            throw; }}
   setstate( state );
   return ( *this );

Les deux groupes de fonctions appellent setstate(badbit) s'ils rencontrent une erreur lors de l'insertion des éléments.

Un objet de basic_istreamElem<, Tr> de la classe enregistre un seul objet de base public virtuel de la classe basic_ios<Elem, Tr>.

Exemple

Consultez l'exemple de basic_ofstream, classe pour en savoir plus sur les flux de sortie.

Constructeurs

basic_ostream

Construit un objet basic_ostream.

Fonctions membres

flush	Vide le tampon.
put	Empile un caractère dans un flux de données.
seekp	Réinitialise la position dans le flux de sortie.
sentinelle	La classe imbriquée décrit un objet dont la déclaration structure les fonctions de sortie formatées et les fonctions de sortie non formatées.
échange	Échange les valeurs de cet objet basic_ostream pour celles de l'objet basic_ostream spécifié.
tellp	Reporte la position dans le flux de sortie.
write (écriture)	Place les caractères dans un flux de données.