std::basic_ostream<CharT,Traits>::flush

 

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::basic_ostream

グローバルオブジェクト
coutwcout	cerrwcerr	clogwclog
メンバ関数
basic_ostream::basic_ostream
basic_ostream::~basic_ostream
basic_ostream::operator= (C++11)
書式付き出力
basic_ostream::operator<<
非書式付き出力
basic_ostream::put
basic_ostream::write
位置付け
basic_ostream::tellp
basic_ostream::seekp
その他
basic_ostream::flush
basic_ostream::swap (C++11)
メンバクラス
basic_ostream::sentry
非メンバ関数
operator<<(std::basic_ostream)
print(std::ostream) (C++23)
println(std::ostream) (C++23)
vprint_unicode(std::ostream) (C++23)
vprint_nonunicode(std::ostream) (C++23)

 

basic_ostream& flush();

未コミットの変更を下流の出力シーケンスに書き込みます。UnformattedOutputFunction として動作します。

rdbuf() がヌルポインタの場合、sentry オブジェクトは構築されません。

それ以外の場合は、sentry オブジェクトを構築してチェックした後、rdbuf()->pubsync() を呼び出します。この呼び出しが -1 を返した場合、setstate(badbit) を呼び出します。

戻り値

*this

例外

(exceptions() & badbit) != 0 の場合、std::ios_base::failure を送出する可能性があります。

例

このコードを実行

#include <chrono>
#include <iostream>
#include <thread>
 
using namespace std::chrono_literals;
 
void f()
{
    std::cout << "Output from thread... ";
    for (int i{1}; i != 10; ++i)
    {
        std::this_thread::sleep_for(250ms);
        std::cout << i << ' ';
 
        // output three numbers at once;
        // the effect is observable only in real-time
        if (0 == (i % 3))
            std::cout.flush();
    }
    std::cout << std::endl; // flushes as well
}
 
int main()
{
    std::thread tr{f};
    std::this_thread::sleep_for(150ms);
    std::clog << "Output from main\n";
    tr.join();
}

出力

Output from main
Output from thread... 1 2 3 4 5 6 7 8 9

不具合報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 581	C++98	flush() は UnformattedOutputFunction として動作しませんでした。 それは	〜として動作します。 UnformattedOutputFunction

関連項目

pubsync	sync() を呼び出す (std::basic_streambuf<CharT,Traits> の public メンバ関数)
sync [virtual]	バッファを関連付けられた文字シーケンスと同期する (std::basic_streambuf<CharT,Traits> の仮想 protected メンバ関数)
flush	出力ストリームをフラッシュする (関数テンプレート)
endl	'\n'を出力し、出力ストリームをフラッシュする (関数テンプレート)
sync	基礎となるストレージデバイスと同期する (std::basic_istream<CharT,Traits> の public メンバ関数)