basic_ostream Class

發行項
03/28/2013

這個樣板類別描述物件來控制插入項目和已編碼的物件型別的項目與資料流緩衝區 Elem，也就是 char_type，其字元特性由類別 Tr，也就是 traits_type。

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

參數

_Elem
char_type。
_Tr
字元traits_type。

備註

大部分的成員函式該多載運算子 << 是格式化的輸出函式。它們會遵循的模式：

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

其他兩個成員函式都是未格式化的輸出函式。它們會遵循的模式：

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

這兩個群組的函式呼叫的 setstate(badbit) 如果他們在插入項目時所遇到失敗。

物件的類別 basic_istream <Elem， Tr> 會儲存只有虛擬公用基底物件類別的 basic_ios< Elem， Tr >。

範例

請參閱範例的basic_ofstream Class若要進一步瞭解輸出資料流。

建構函式

basic_ostream

建構 basic_ostream 物件。

成員函式

排清	清除緩衝區。
放入	將資料流中的字元。
seekp	重設輸出資料流中的位置。
哨兵	巢狀的類別會描述其宣告結構的格式化的輸出函式和未格式化的輸出函式的物件。
交換	交換的值basic_ostream物件所提供的basic_ostream物件。
tellp	在報表中的位置輸出資料流。
write	將資料流中的字元。