std::basic_ostream

namespace std {
  template<class CharT, class Traits = char_traits<CharT>>
  class basic_ostream : virtual public basic_ios<CharT, Traits> { …… };

  using ostream  = basic_ostream<char>;
  using wostream = basic_ostream<wchar_t>;
}

概要

basic_ostream は、出力ストリームを表現するクラスである。 すなわち、rdbuf() が指し示すストリームバッファオブジェクトに対する書き込み操作を提供する。

各種の出力関数——特に<<演算子——がクラスのメンバ関数・非メンバ関数として定義されている。 このため、ユーザーコードで入力処理を実装する際には、basic_ostream、あるいはそれに対する別名であるostreamやwostreamなどの型への参照を実引数として受け取るようにすると良い。

テンプレートパラメータとして文字型を受け取るようになっており、使用を容易にするため、以下のパラメータ設定済みエイリアスが定義されている。 このエイリアスは<ostream>ヘッダと<iosfwd>ヘッダで定義されている。

書式化出力関数と非書式化出力関数

basic_ostreamでの出力操作は、書式化出力関数と非書式化出力関数の2種類に分類される。

書式化出力関数と非書式化出力関数の効果

注意：書式化出力関数と非書式化出力関数すべてについて、「効果」の項目は以下の処理を前提として記載している。

書式化出力関数・非書式化出力関数は、出力処理に先立ってsentryオブジェクトを構築し、関数から脱出する前に破棄する。 構築した sentry オブジェクトが operator bool 関数で true に変換できる場合のみ、実際の出力処理（各関数の「効果」として記載した処理）が実行される。

（書式化出力関数のみ）operator bool 関数の結果が false であったら、setstate(ios_base::badbit) を呼び出す。

関数内部で例外が送出された場合、ios_base::badbit を設定する。 そして、(exceptions() & badbit) != 0 であれば例外を再送出する。

メンバ

基底クラスである ios_base とbasic_ios も参照のこと。

型

構築・破棄

• コピーコンストラクタとコピー代入演算子はdelete定義されている。
• ムーブコンストラクタ・ムーブ代入演算子とswapはprotectedで定義されている。

出力処理

<<演算子のほとんどは書式化出力関数である。 その他のメンバ関数は非書式化出力関数である。

シーク

protectedメンバ関数

非メンバ関数

参照

• 基底クラス
  • ios_base
  • basic_ios
• basic_ostream<>型のオブジェクト
  • cout
  • wcout
  • clog
  • wclog
  • cerr
  • wcerr