set_rdbuf.md

set_rdbuf

• ios[meta header]
• std[meta namespace]
• basic_ios[meta class]
• function[meta id-type]
• cpp11[meta cpp]

protected:
  void set_rdbuf(basic_streambuf<CharT, Traits>* sb); // (1) C++11

• basic_streambuf[link ../../streambuf/basic_streambuf.md]

概要

ストリームバッファオブジェクトを設定する。

要件

sb はヌルポインタでは無いこと

効果

*this に紐づくストリームバッファ（basic_streambuf）オブジェクトを引数 sb に設定する（rdbuf() == sb となる）。
なお、publicメンバ関数の rdbuf と異なり、ストリームバッファオブジェクトの設定後、clear() は呼び出さない。

戻り値

無し

例外

投げない

バージョン

言語

• C++11

参照

• rdbuf
• LWG Issue 1183. basic_ios::set_rdbuf may break class invariants
  • C++11で、sbがヌルポインタでないという要件が追加された。ヌルポインタを設定すると、clear()を呼ばないこの関数ではエラー状態が更新されず、クラス不変条件が壊れるため