std::strstreambuf::overflow

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

入出力ライブラリ

I/Oマニピュレータ

出力関数 (C++23)

C形式I/O

バッファ

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

ストリーム

抽象化

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

ファイルI/O

basic_ifstream

basic_ofstream

basic_fstream

文字列I/O

basic_istringstream

basic_ostringstream

basic_stringstream

配列I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同期出力

basic_osyncstream (C++20)

型

streamoff

streamsize

fpos

エラーカテゴリインターフェース

iostream_category (C++11)

io_errc (C++11)

 

std::strstreambuf

公開メンバ関数

strstreambuf::strstreambuf

strstreambuf::~strstreambuf

strstreambuf::freeze

strstreambuf::str

strstreambuf::pcount

Protected member functions

strstreambuf::underflow

strstreambuf::pbackfail

strstreambuf::overflow

strstreambuf::setbuf

strstreambuf::seekoff

strstreambuf::seekpos

 

protected: virtual int_type overflow( int_type c = EOF );		(C++98で非推奨) (C++26で削除)

バッファの書き込み領域に文字 c を追加します。可能であれば再割り当てを行います。

1) c == EOF の場合、何も行いません。

2) それ以外の場合、書き込み領域に利用可能な書き込み位置がある (pptr() < epptr()) 場合、文字は *pptr()++ = c のように格納されます。

3) それ以外の場合、ストリームバッファモードが動的でないか、ストリームバッファが現在フリーズされている場合、関数は失敗し EOF を返します。

4) それ以外の場合、関数は、現在の動的配列（存在する場合）の内容に加えて少なくとも 1 つの追加の書き込み位置を保持するのに十分な大きさの動的配列を再割り当て（または最初に割り当て）します。コンストラクタで割り当て関数 palloc へのポインタが使用されていた場合、その関数は (*palloc)(n) として呼び出されます。ここで n は割り当てるバイト数です。そうでない場合は、new char[n] が使用されます。コンストラクタで解放関数 pfree へのポインタが使用されていた場合、その関数は必要に応じて前の配列を解放するために (*pfree)(p) として呼び出されます。そうでない場合は、delete[] p が使用されます。割り当てに失敗した場合、関数は失敗し EOF を返します。

パラメータ

c

-

出力領域に格納する文字

戻り値

c == EOF の場合、EOF 以外の値を返します。それ以外の場合、成功時は (unsigned char)(c) を返し、失敗時は EOF を返します。

例

このコードを実行

#include <iostream>
#include <strstream>
 
struct mybuf : std::strstreambuf
{
    int_type overflow(int_type c) 
    {
        std::cout << "Before overflow(): size of the put area is " << epptr()-pbase()
                  << " with " << epptr()-pptr() << " write positions available\n";
        int_type rc = std::strstreambuf::overflow(c);
        std::cout << "After overflow(): size of the put area is " << epptr()-pbase()
                  << " with " << epptr()-pptr() << " write positions available\n";
        return rc;
    }
};
 
int main()
{
    mybuf sbuf; // read-write dynamic strstreambuf
    std::iostream stream(&sbuf);
 
    stream << "Sufficiently long string to overflow the initial allocation, at least "
           << " on some systems.";
}

実行結果の例

Before overflow(): size of the put area is 16 with 0 write positions available
After overflow(): size of the put area is 32 with 15 write positions available
Before overflow(): size of the put area is 32 with 0 write positions available
After overflow(): size of the put area is 64 with 31 write positions available
Before overflow(): size of the put area is 64 with 0 write positions available
After overflow(): size of the put area is 128 with 63 write positions available

関連項目

overflow [virtual]	関連付けられた出力シーケンスに、配置領域から文字を書き込む (std::basic_streambuf<CharT,Traits> の仮想 protected メンバ関数)
overflow [virtual]	出力シーケンスに文字を追加する (std::basic_stringbuf<CharT,Traits,Allocator> の仮想保護メンバ関数)
overflow [virtual]	ファイルバッファの格納領域から、関連付けられたファイルへ文字を書き込みます。 (std::basic_filebuf<CharT,Traits> の保護仮想メンバ関数)
sputc	配置領域に1文字を書き込み、次のポインタを進める (std::basic_streambuf<CharT,Traits> の public メンバ関数)
put	文字を挿入する (std::basic_ostream<CharT,Traits> の public メンバ関数)