5. コンストラクタ

最終更新日時:
が更新

履歴 編集

function
<syncstream>

std::basic_syncbuf::コンストラクタ(C++20)

basic_syncbuf() : basic_syncbuf(nullptr) {}                       // (1) C++20
explicit basic_syncbuf(streambuf_type* obuf)
  : basic_syncbuf(obuf, Allocator()) { }                          // (2) C++20
basic_syncbuf(streambuf_type* obuf, const Allocator& allocator);  // (3) C++20
basic_syncbuf(basic_syncbuf&& other);                             // (4) C++20

概要

  • (1) : デフォルトコンストラクタ。
  • (2) : ラップするstd::basic_streambufへのポインタを受け取る。
  • (3) : ラップするstd::basic_streambufへのポインタ、アロケータを受け取る。
  • (4) : ムーブコンストラクタ。

ただし、これらは通常std::basic_osyncstreamから呼ばれる。

効果

  • (1), (2), (3) : 同期時排出ポリシー(sync()が呼ばれたときemit()を呼び出すかどうか)をfalseに設定し、std::basic_syncbufオブジェクトを作成し、ラップされたストリームバッファをobufに設定する（(1)ではnullptr）。obufが、関連する出力の最終的な宛先になる。
  • (4) : 他のオブジェクトからムーブコンストラクトする。

例外

事後条件

  • (1), (2), (3) : get_wrapped() == obufとget_allocator() == allocatorがtrueとなる。
  • (4) : this->get_wrapped()によって返される値は、このコンストラクタを呼び出す前にother.get_wrapped()によって返される値である。 このコンストラクタを呼び出す前にotherに格納された出力は、*thisに格納される。 other.rdbuf()->pbase() == other.rdbuf()->pptr()とother.get_wrapped() == nullptrはtrueである。

備考

  • (1), (2), (3) : アロケータのコピーは、関連する出力を保持する内部バッファにメモリを割り当てるために使用される。
  • (4) : このコンストラクタは、otherをそのラップされたストリームバッファから切り離し、otherの破棄によって出力がされないようにする。

例

#include <iostream>
#include <syncstream>

int main()
{
  std::osyncstream bout{std::cout}; // 通常 std::basic_osyncstream から呼ばれる。
  bout << "Hello, World!";
}

出力

Hello, World!

バージョン

言語

  • C++20

処理系

参照