std::cin, std::wcin

 

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_istream

グローバルオブジェクト

cinwcin

メンバ関数

basic_istream::basic_istream

basic_istream::~basic_istream

basic_istream::operator= (C++11)

書式付き入力

basic_istream::operator>>

書式なし入力

basic_istream::get

basic_istream::peek

basic_istream::unget

basic_istream::putback

basic_istream::getline

basic_istream::ignore

basic_istream::read

basic_istream::readsome

basic_istream::gcount

位置付け

basic_istream::tellg

basic_istream::seekg

その他

basic_istream::sync

basic_istream::swap (C++11)

メンバクラス

basic_istream::sentry

非メンバ関数

operator>>(std::basic_istream)

 

ヘッダ <iostream> で定義
extern std::istream cin;	(1)
extern std::wistream wcin;	(2)

グローバルオブジェクト std::cin と std::wcin は、標準 C 入力ストリーム stdin に関連付けられた、実装定義の型 (std::streambuf から派生) のストリームバッファからの入力を制御します。

これらのオブジェクトは、型 std::ios_base::Init のオブジェクトが最初に構築される際、またはそれ以前に初期化されることが保証されており、順序付けられた初期化を持つ静的オブジェクトのコンストラクタとデストラクタで使用可能です (オブジェクトが定義される前に <iostream> がインクルードされている限り)。

sync_with_stdio(false) が発行されていない限り、フォーマット済み入力と非フォーマット済み入力の両方について、これらのオブジェクトに複数のスレッドから同時にアクセスしても安全です。

初期化後

1) std::cin.tie() は &std::cout を返します。これは、std::cin での入力操作は、出力待ちの文字がある場合、std::cout.flush() の呼び出しを強制することを意味します。

2) std::wcin.tie() は &std::wcout を返します。これは、std::wcin での入力操作は、出力待ちの文字がある場合、std::wcout.flush() の呼び出しを強制することを意味します。

備考

名前に含まれる「c」は「character (文字)」を指します (stroustrup.com FAQ)。cin は「character input (文字入力)」を意味し、wcin は「wide character input (ワイド文字入力)」を意味します。

例

このコードを実行

#include <iostream>
 
struct Foo
{
    int n;
    Foo()
    {
        std::cout << "Enter n: "; // no flush needed
        std::cin >> n;
    }
};
 
Foo f; // static object
 
int main()
{
    std::cout << "f.n is " << f.n << '\n';
}

実行結果の例

Enter n: 10
f.n is 10

関連項目

Init	標準ストリームオブジェクトを初期化する (std::ios_base の public メンバクラス)
coutwcout	標準C出力ストリーム stdout に書き込む (グローバルオブジェクト)
stdinstdoutstderr	入力ストリームに関連付けられた FILE* 型の式 出力ストリームに関連付けられた FILE* 型の式 エラー出力ストリームに関連付けられた FILE* 型の式 (マクロ定数)