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

`、`$`タグ内のテキスト、およびC++固有の用語は翻訳せず、元のフォーマットを保持しました。$

ストリームにデータを挿入します。

パラメータ

戻り値

注記

非静的メンバへのポインタに対するオーバーロードは存在しません 、volatile修飾された型へのポインタ、 (C++23まで) または関数ポインタ ( 18-20 ) のオーバーロードで受け入れられるシグネチャを持つものを除く）。

• そのようなオブジェクトを出力しようとすると、 bool への暗黙変換が呼び出され、非ヌルポインタ値の場合、値 1 が出力される（ boolalpha が設定されている場合は、 true が出力される）。

文字および文字列の引数（例: 型 char または const char * ）は、 非メンバーオーバーロード によって処理されます。 operator << の

• メンバ関数呼び出し構文（例： std:: cout . operator << ( 'c' ) ; ）を使用して文字を出力しようとすると、 ( 2-5 ) または ( 11-14 ) のオーバーロードのいずれかが呼び出され、数値が出力されます。
• メンバ関数呼び出し構文を使用して文字列を出力しようとすると、オーバーロード (8) が呼び出され、代わりにポインタ値が表示されます。

オーバーロード (10) は LWG issue 2221 の解決により追加されましたが、C++11/14モードではどの標準ライブラリ実装でも実装されていません。

例

#include <iomanip>
#include <iostream>
#include <sstream>
int fun() { return 42; }
int main()
{
    std::istringstream input(" \"Some text.\" ");
    double f = 3.14;
    bool b = true;
    std::cout
        << fun()          // int オーバーロード (12)
        << ' '            // 非メンバーオーバーロード
        << std::boolalpha // 関数オーバーロード (18)
        << b              // bool オーバーロード (1)
        << " "            // 非メンバーオーバーロード
        << std::fixed     // 関数オーバーロード (18) 再び
        << f              // double オーバーロード (6)
        << input.rdbuf()  // streambuf オーバーロード
        << fun            // bool オーバーロード (1): int(*)() のオーバーロードは存在しない
        << std::endl;     // 関数オーバーロード (18) 再び
    int x = 0;
    int* p1 = &x;
    volatile int* p2 = &x;
    std::cout
        << "p1: " << p1 << '\n'  // `const void*` オーバーロード、アドレスを出力
        << "p2: " << p2 << '\n'; // C++23 以前 (P1147): bool オーバーロード :)、なぜなら
            // operator<<(const void*) は `volatile` 修飾子を破棄するため適合しない
            // これを修正するため、C++23 は `const volatile void*` オーバーロード (9) を追加し、
            // 期待通りアドレスを出力する
}

42 true 3.140000 "Some text." true
p1: 0x7ffcea766600
p2: 0x7ffcea766600

不具合報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

関連項目