operator>>(std::basic_istream)

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

輸入/輸出庫

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)

 

定義於標頭檔案 <istream>
template< class CharT, class Traits > basic_istream<CharT, Traits>&     operator>>( basic_istream<CharT, Traits>& st, CharT& ch ); template< class Traits > basic_istream<char, Traits>&     operator>>( basic_istream<char, Traits>& st, signed char& ch ); template< class Traits > basic_istream<char, Traits>&     operator>>( basic_istream<char, Traits>& st, unsigned char& ch );	(1)
	(2)
template< class CharT, class Traits> basic_istream<CharT, Traits>&     operator>>( basic_istream<CharT, Traits>& st, CharT* s ); template< class Traits > basic_istream<char, Traits>&     operator>>( basic_istream<char, Traits>& st, signed char* s ); template< class Traits > basic_istream<char, Traits>&     operator>>( basic_istream<char, Traits>& st, unsigned char* s );			(C++20 前)
template< class CharT, class Traits, std::size_t N > basic_istream<CharT, Traits>&     operator>>( basic_istream<CharT, Traits>& st, CharT (&s)[N] ); template< class Traits, std::size_t N > basic_istream<char, Traits>&     operator>>( basic_istream<char, Traits>& st, signed char (&s)[N] ); template< class Traits, std::size_t N > basic_istream<char, Traits>&     operator>>( basic_istream<char, Traits>& st, unsigned char (&s)[N] );			(C++20 起)
template< class Istream, class T > Istream&&     operator>>( Istream&& st, T&& value );		(3)	(C++11 起)

1,2) 執行字元輸入操作。

1) 行為如同一個 FormattedInputFunction。在構造並檢查哨兵物件（可能會跳過開頭的空白字元）後，提取一個字元並將其儲存到 ch。如果無可用字元，則設定 failbit（此外還會設定 eofbit，這是 FormattedInputFunction 的要求）。

2) 行為如同一個 FormattedInputFunction。在構造並檢查哨兵物件（可能會跳過開頭的空白字元）後，提取連續字元並將其儲存到字元陣列的連續位置，該陣列的第一個元素由(C++20 前) s 指向。當滿足以下任何條件時，提取停止：

• 找到空白字元（由 ctype<CharT> facet 決定）。空白字元不被提取。

如果 st.width() 大於零，則儲存 st.width() - 1 個字元。	(C++20 前)
儲存了 n - 1 個字元，其中 n 定義如下： 如果 st.width() 大於零，則為 std::min(std::size_t(st.width()), N)； 否則，n 為 N。	(C++20 起)

• 輸入序列中發生檔案結束（這也會設定 eofbit）。

在任一情況下，都會在輸出的末尾儲存一個額外的空字元值 CharT()。如果未提取任何字元，則設定 failbit（空字元仍會寫入到輸出的第一個位置）。最後，呼叫 st.width(0) 以取消 std::setw 的影響（如果有）。

3) 給定一個對輸入流物件的右值引用，呼叫適當的提取運算子（等價於 st >> std::forward<T>(value)）。此過載僅在 st >> std::forward<T>(value) 格式良好且 Istream 是公開且明確地從 std::ios_base 派生的類型別時才參與過載決議。

注意

提取作為流最後一個字元的單個字元不會設定 eofbit：這與其他格式化輸入函式（例如使用 operator>> 提取最後一個整數）不同，但此行為與 std::scanf 使用 "%c" 格式說明符時的行為匹配。

引數

st	-	用於提取資料的輸入流
ch	-	對字元的引用，用於儲存提取的字元
s	-	指向(C++20 前) 字元陣列的指標，用於儲存提取的字元

返回值

1,2) st

3) std::move(st)

示例

執行此程式碼

#include <iomanip>
#include <iostream>
#include <sstream>
 
int main()
{
    std::string input = "n greetings";
    std::istringstream stream(input);
 
    char c;
    const int MAX = 6;
    char cstr[MAX];
 
    stream >> c >> std::setw(MAX) >> cstr;
    std::cout << "c = " << c << '\n'
              << "cstr = " << cstr << '\n';
 
    double f;
    std::istringstream("1.23") >> f; // rvalue stream extraction
    std::cout << "f = " << f << '\n';
}

輸出

c = n
cstr = greet
f = 1.23

缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 13	C++98	n 的定義提及了不存在的名稱 eos	替換為 CharT()
LWG 68	C++98	過載 (2) 的輸出末尾未儲存空字元	儲存一個空字元
LWG 1203	C++98	右值流的過載返回了基類的左值引用	返回右值引用 到派生類
LWG 2328	C++98	右值流的過載要求另一個引數為左值	改為接受右值
LWG 2534	C++98	右值流的過載未受約束	已受約束

參閱

operator>>

提取格式化資料 (公有成員函式)