basic_ostream-Klasse

Artikel
06/09/2015

Diese Vorlagenklasse beschreibt ein Objekt, das Einfügen von Elementen und kodierter Objekten in einen Streampuffer mit Elementen des Typs Elem, steuert auch char_type, dessen Zeichenmerkmale durch die Klasse Tr festgelegt werden, auch traits_type.

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

Parameter

_Elem
char_type
_Tr
Das Zeichen traits_type.

Hinweise

Die meisten Memberfunktionen, die Operator <<, sind überladen formatierte Ausgabefunktionen. Sie folgen dem Muster:

   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 );

Zwei andere Memberfunktionen sind unformatierte Ausgabefunktionen. Sie folgen dem Muster:

   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 );

Beide Gruppen Funktionen rufen setstate auf (badbit), wenn sie einen Fehler beim Einfügen von Elementen auftreten.

Ein Objekt basic_istream <von Klasse Elem, Tr> speichert nur ein virtuelles öffentliches Basisobjekt der Klasse basic_ios<Elem, Tr >.

Beispiel

Im Beispiel für basic_ofstream-Klasse, um mehr über Ausgabestreams zu erfahren.

Konstruktoren

basic_ostream

Erstellt ein basic_ostream-Objekt.

Memberfunktionen

leer	Leert den Puffer.
setzen Sie sich	Setzt ein Zeichen in einen Stream ein.
seekp	Rücksetzungsposition im Ausgabestream.
Wache	Die geschachtelte Klasse beschreibt ein Objekt, dessen Deklaration die formatierten Ausgabefunktionen und die unformatierten Ausgabefunktionen strukturiert.
swap	Vertauscht die Werte für die basic_ostream dieses Objekts des bereitgestellten basic_ostream-Objekts aus.
tellp	Berichte positionieren im Ausgabestream.
write	Setzt Zeichen in einen Stream ein.