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

 

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)

 

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

從輸入流中提取值。

1-11) 提取一個值，可能跳過前面的空白字元。該值儲存到給定的引用 value 中。

此函式表現為 FormattedInputFunction。在構造並檢查崗哨物件（可能會跳過開頭的空白字元）之後，透過呼叫 std::num_get::get() 提取一個值。

12) 提取一個 short 值，可能跳過前面的空白字元。該值儲存到給定的引用 value 中。

此函式表現為 FormattedInputFunction。在構造並檢查崗哨物件（可能會跳過開頭的空白字元）之後，透過呼叫 std::num_get::get() 提取一個 long 值 lval。之後

• 如果 lval < std::numeric_limits<short>::min()，則設定 failbit 並將 std::numeric_limits<short>::min() 儲存到 val 中。
• 否則，如果 std::numeric_limits<short>::max() < lval，則設定 failbit 並將 std::numeric_limits<short>::max() 儲存到 val 中。
• 否則，將 static_cast<short>(lval) 儲存到 val 中。

13) 提取一個 int 值，可能跳過前面的空白字元。該值儲存到給定的引用 value 中。

此函式表現為 FormattedInputFunction。在構造並檢查崗哨物件（可能會跳過開頭的空白字元）之後，透過呼叫 std::num_get::get() 提取一個 long 值 lval。之後

• 如果 lval < std::numeric_limits<int>::min()，則設定 failbit 並將 std::numeric_limits<int>::min() 儲存到 val 中。
• 否則，如果 std::numeric_limits<int>::max() < lval，則設定 failbit 並將 std::numeric_limits<int>::max() 儲存到 val 中。
• 否則，將 static_cast<int>(lval) 儲存到 val 中。

14) 提取一個擴充套件浮點值，可能跳過前面的空白字元。該值儲存到給定的引用 value 中。庫為所有 cv-unqualified 擴充套件浮點型別 提供過載作為引數 value 的引用型別。

確定標準浮點型別 FP 如下：

• 如果 /* extended-floating-point-type */ 的 浮點轉換等級 小於或等於 float 的等級，則 FP 為 float。
• 否則，如果 /* extended-floating-point-type */ 的浮點轉換等級小於或等於 double 的等級，則 FP 為 double。
• 否則，FP 為 long double。

此函式表現為 FormattedInputFunction。在構造並檢查崗哨物件（可能會跳過開頭的空白字元）之後，透過呼叫 std::num_get::get() 提取一個 FP 值 fval。之後

• 如果 fval < -std::numeric_limits</* extended-floating-point-type */>::max()，則設定 failbit 並將 -std::numeric_limits</* extended-floating-point-type */>::max() 儲存到 val 中。
• 否則，如果 std::numeric_limits</* extended-floating-point-type */>::max() < fval，則設定 failbit 並將 std::numeric_limits</* extended-floating-point-type */>::max() 儲存到 val 中。
• 否則，將 static_cast</* extended-floating-point-type */>(fval) 儲存到 val 中。

15-17) 呼叫 func(*this)，其中 func 是一個 I/O 操縱符。

18) 表現為 UnformattedInputFunction。在構造並檢查崗哨物件之後，從 *this 提取所有資料並將其儲存到 sb 中。當滿足以下條件之一時，提取停止：

• 輸入序列中出現檔案結束；
• 插入到輸出序列中失敗（在這種情況下，要插入的字元不會被提取）；
• 發生異常（在這種情況下，異常被捕獲，並且只有在未插入任何字元且 exceptions() 中啟用了 failbit 時才重新丟擲）。

在任何一種情況下，都將提取的字元數儲存在後續呼叫 gcount() 訪問的成員變數中。如果 sb 是空指標，或者沒有字元插入到 sb 中，則呼叫 setstate(failbit)（如果啟用，可能會丟擲 std::ios_base::failure）。

如果提取失敗（例如，如果在預期數字的地方輸入了字母），則會將零寫入 value 並設定 failbit。對於有符號整數，如果提取的值太大或太小，無法放入 value 中，則會寫入 std::numeric_limits<T>::max() 或 std::numeric_limits<T>::min()（分別）並設定 failbit 標誌。對於無符號整數，如果提取的值太大或太小，無法放入 value 中，則會寫入 std::numeric_limits<T>::max() 並設定 failbit 標誌。

引數

value	-	對整數或浮點值的引用，用於儲存提取的值
func	-	指向 I/O 操縱符函式的指標
sb	-	指向流緩衝區的指標，所有資料都將寫入其中

返回值

1-16,18) *this

17) func(*this)

注意

對於過載 (14)，當擴充套件浮點型別的浮點轉換等級與任何標準浮點型別的等級不相等時，轉換期間的雙重舍入可能導致不準確的結果。std::from_chars() 可用於需要最大精度的情況。

示例

執行此程式碼

#include <iomanip>
#include <iostream>
#include <sstream>
 
int main()
{
    std::string input = "41 3.14 false hello world";
    std::istringstream stream(input);
 
    int n;
    double f;
    bool b;
 
    stream >> n >> f >> std::boolalpha >> b;
    std::cout << "n = " << n << '\n'
              << "f = " << f << '\n'
              << "b = " << std::boolalpha << b << '\n';
 
    // extract the rest using the streambuf overload
    stream >> std::cout.rdbuf();
    std::cout << '\n';
}

輸出

n = 41
f = 3.14
b = false
hello world

缺陷報告

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

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 64	C++98	不清楚過載 (18) 是否只能重新丟擲 呼叫 setstate(failbit) 丟擲的 std::ios_base::failure	所有捕獲的異常 都可以重新丟擲
LWG 118	C++98	過載 (12,13) 將提取委託給 num_get::get， 但它沒有 short 和 int 的過載	提取一個 long 值 而不是 short 或 int
LWG 413	C++98	過載 (18) 只重新丟擲在從 sb 提取字元時丟擲的異常 但是字元是從 *this 提取的	將 sb 更正為 *this
LWG 567	C++98	過載 (18) 表現為 FormattedInputFunction 由於 LWG issue 60 的決議	它表現為 UnformattedInputFunction（非格式化輸入函式）
LWG 661	C++98	過載 (12,13) 未將提取的數字儲存到 value 中，由於 LWG issue 118 的解決	如果未發生溢位，則儲存該數字 未發生溢位
LWG 696	C++98	在提取失敗時，value 未改變	設定為零或最小值/ 最大值

另請參閱

operator>>(std::basic_istream)	提取字元和字元陣列 (函式模板)
operator<<operator>>	對字串執行流輸入和輸出 (函式模板)
operator<<operator>>	執行位集的流輸入和輸出 (函式模板)
operator<<operator>>	序列化和反序列化複數 (函式模板)
operator<<operator>> (C++11)	對偽隨機數引擎執行流輸入和輸出 (函式模板)
operator<<operator>> (C++11)	對偽隨機數分佈執行流輸入和輸出 (函式模板)
read	提取字元塊 (公共成員函式)
readsome	提取已有的字元塊 (公共成員函式)
get	提取字元 (公共成員函式)
getline	提取字元直到找到給定字元 (公共成員函式)
from_chars (C++17)	將字元序列轉換為整數或浮點值 (函式)