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

basic_ostream& operator<<( bool value );	(1)
basic_ostream& operator<<( long value );	(2)
basic_ostream& operator<<( unsigned long value );	(3)
basic_ostream& operator<<( long long value );	(4)	(C++11以降)
basic_ostream& operator<<( unsigned long long value );	(5)	(C++11以降)
basic_ostream& operator<<( double value );	(6)
basic_ostream& operator<<( long double value );	(7)
basic_ostream& operator<<( const void* value );	(8)
basic_ostream& operator<<( const volatile void* value );	(9)	(C++23から)
basic_ostream& operator<<( std::nullptr_t );	(10)	(C++17以降)
basic_ostream& operator<<( short value );	(11)
basic_ostream& operator<<( int value );	(12)
basic_ostream& operator<<( unsigned short value );	(13)
basic_ostream& operator<<( unsigned int value );	(14)
basic_ostream& operator<<( float value );	(15)
basic_ostream& operator<<( /* extended-floating-point-type */ value );	(16)	(C++23から)
basic_ostream& operator<<( std::basic_streambuf<CharT, Traits>* sb );	(17)
basic_ostream& operator<<( std::ios_base& (*func)(std::ios_base&) );	(18)
basic_ostream& operator<<( std::basic_ios<CharT, Traits>& (*func)(std::basic_ios<CharT, Traits>&) );	(19)
basic_ostream& operator<<( std::basic_ostream<CharT, Traits>& (*func) (std::basic_ostream<CharT, Traits>&) );	(20)

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

1-8) value を挿入する。

この関数は FormattedOutputFunction として動作する。セントリーオブジェクトを構築してチェックした後、std::num_put::put() を呼び出して値を挿入する。出力中にファイル終端条件に遭遇した場合 (put().failed() == true)、badbit を設定する。

9) return operator<<(const_cast<const void*>(p)); と等価。

10) return *this << s; と等価。ここで s は実装定義の null 終端文字型文字列である。

11) short value から値を挿入する。

この関数は FormattedOutputFunction として動作する。セントリーオブジェクトを構築してチェックした後、(2) と同じように long 型の lval を挿入する。ここで lval は、

flags() & std::ios_base::basefield が std::ios_base::oct または std::ios_base::hex の場合、static_cast<long>(static_cast<unsigned short>(value))、それ以外の場合は
static_cast<long>(value) である。

12) int value から値を挿入する。

この関数は FormattedOutputFunction として動作する。セントリーオブジェクトを構築してチェックした後、(2) と同じように long 型の lval を挿入する。ここで lval は、

flags() & std::ios_base::basefield が std::ios_base::oct または std::ios_base::hex の場合、static_cast<long>(static_cast<unsigned int>(value))、それ以外の場合は
static_cast<long>(value) である。

13,14) unsigned short または unsigned int value から値を挿入する。

この関数は FormattedOutputFunction として動作する。セントリーオブジェクトを構築してチェックした後、(3) と同じように static_cast<unsigned long>(value) を挿入する。

15) float value から値を挿入する。

この関数は FormattedOutputFunction として動作する。セントリーオブジェクトを構築してチェックした後、(6) と同じように static_cast<double>(value) を挿入する。

16) value から値を挿入する。ライブラリは、パラメータ値の型として、すべての cv-unqualified な拡張浮動小数点型のオーバーロードを提供する。

この関数は FormattedOutputFunction として動作する。セントリーオブジェクトを構築してチェックした後、/* extended-floating-point-type */ の浮動小数点変換ランクをチェックする。

ランクが double のランク以下の場合、(6) と同じように static_cast<double>(value) を挿入する。
それ以外の場合、ランクが long double のランク以下の場合、(7) と同じように static_cast<long double>(value) を挿入する。
それ以外の場合、このオーバーロードの呼び出しは、実装定義のセマンティクスで条件付きでサポートされる。

17) この関数は UnformattedOutputFunction として動作する。セントリーオブジェクトを構築してチェックした後、sb がヌルポインタであるかどうかをチェックする。ヌルポインタの場合、setstate(badbit) を実行して終了する。それ以外の場合、次のいずれかの条件が満たされるまで、sb が制御する入力シーケンスから文字を抽出し、*this に挿入する。

入力シーケンスでファイル終端が発生する。
出力シーケンスへの挿入が失敗する (この場合、挿入される文字は抽出されない)。
例外が発生する (この場合、例外は捕捉される)。

文字が挿入されなかった場合、setstate(failbit) を実行する。抽出中に例外がスローされた場合、failbit を設定し、exceptions() で failbit が設定されている場合、例外を再スローする。

18-20) func(*this) を呼び出す。これらのオーバーロードは、std::endl などの出力 I/O マニピュレータを実装するために使用される。

メンバ関数呼び出し構文を使用して文字を出力しようとすると（例：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 overload (12)
        << ' '            // non-member overload
        << std::boolalpha // function overload (18)
        << b              // bool overload (1)
        << " "            // non-member overload
        << std::fixed     // function overload (18) again
        << f              // double overload (6)
        << input.rdbuf()  // streambuf overload
        << fun            // bool overload (1): there's no overload for int(*)()
        << std::endl;     // function overload (18) again
 
    int x = 0;
    int* p1 = &x;
    volatile int* p2 = &x;
    std::cout
        << "p1: " << p1 << '\n'  // `const void*` overload, prints address
        << "p2: " << p2 << '\n'; // before C++23 (P1147): bool overload :), because
            // operator<<(const void*) is not a match, as it discards the `volatile`
            // qualifier. To fix this, C++23 adds `const volatile void*` overload (9),
            // that prints the address as expected.
}

実行結果の例

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

[編集] 欠陥報告

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

DR	適用対象	公開された動作	正しい動作
LWG 117	C++98	オーバーロード (1-8,11-15) は挿入を `num_put::put` に委譲したが、short、 unsigned short、int、unsigned int、および float のオーバーロードがないため、	それらは渡される前に `num_put::put` に変換される。 LWG 567
オーバーロード (17) は FormattedOutputFunction として動作していた。	C++98	LWG issue 60 の解決により、それは	として動作する。 UnformattedOutputFunction

[編集] 関連項目

operator<<(std::basic_ostream)	文字データを挿入する、または右辺値ストリームに挿入する (function template) [編集]
operator<<operator>>	文字列に対するストリーム入出力を実行する (function template) [編集]
operator<< (C++17)	string viewのストリーム出力を行う (function template) [編集]
operator<<operator>>	ビットセットのストリーム入出力を実行する (function template) [編集]
operator<<operator>>	複素数をシリアライズ・デシリアライズする (関数テンプレート) [編集]
operator<<operator>> (C++11)	疑似乱数エンジンのストリーム入出力を実行 (関数テンプレート) [編集]
operator<<operator>> (C++11)	疑似乱数分布のストリーム入出力を実行 (関数テンプレート) [編集]
put	文字を挿入する (public member function) [編集]
write	文字ブロックを挿入する (public member function) [編集]
to_chars (C++17)	整数値または浮動小数点数値を文字シーケンスに変換する (関数) [編集]

コンパイラサポート
フリースタンディングとホスト
言語
標準ライブラリ
標準ライブラリヘッダー
名前付き要件
機能テストマクロ (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)

cppreference.com

名前空間

変種

表示

操作

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

目次

[編集] パラメータ

[編集] 戻り値

[編集] 備考

[編集] 例

[編集] 欠陥報告

[編集] 関連項目

ナビゲーション

ツールボックス

value	-	挿入する整数、浮動小数点、ブール値、またはポインタ値
func	-	呼び出す関数
sb	-	データを読み込むストリームバッファへのポインタ