std::basic_istream

 

C++

編譯器支援

獨立式與託管式

語言

標準函式庫

標準函式庫標頭檔

具名要求

特性測試巨集 (C++20)

語言支援函式庫

概念函式庫 (C++20)

診斷函式庫

記憶體管理函式庫

元編程函式庫 (C++11)

通用公用程式函式庫

容器函式庫

疊代器函式庫

Ranges 函式庫 (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 = std::char_traits<CharT> > class basic_istream : virtual public std::basic_ios<CharT, Traits>

類別模板 basic_istream 支援對字元串流執行高階輸入操作。支援的操作包括格式化輸入 (例如整數值或由空白字元分隔的字元和字元字串) 和非格式化輸入 (例如原始字元和字元陣列)。此功能是透過底層 basic_streambuf 類別所提供的介面來實作的，該介面可透過 basic_ios 基礎類別來存取。在大多數實作中，basic_istream 唯一非繼承的資料成員是由 basic_istream::gcount() 返回的值。

繼承圖

為常見的字元型別提供了數個 typedef：

定義於標頭檔 <istream>
類型	定義
std::istream	std::basic_istream<char>
std::wistream	std::basic_istream<wchar_t>

全域物件

標準函式庫提供了兩個全域的 basic_istream 物件。

定義於標頭檔 <iostream>
cinwcin	從標準 C 輸入串流 stdin 讀取 (全域物件)

成員型別

成員型別	定義
char_type	CharT
traits_type	Traits；若 Traits::char_type 不為 CharT，則程式形式不良 (ill-formed)。
int_type	Traits::int_type
pos_type	Traits::pos_type
off_type	Traits::off_type

成員函式

(建構子)	建構物件 (公有成員函式)
(解構函式) [虛擬]	解構物件 (虛擬公有成員函式)
operator= (C++11)	從另一個 basic_istream 移動賦值 (保護成員函式)
格式化輸入
operator>>	提取格式化數據 (公有成員函式)
非格式化輸入
get	擷取字元 (公有成員函式)
peek	讀取下一個字元但不擷取它 (公有成員函式)
unget	復原擷取字元 (公有成員函式)
putback	將字元放回輸入串流 (公有成員函式)
getline	擷取字元直到找到指定的字元為止 (公有成員函式)
ignore	擷取並丟棄字元直到找到指定的字元為止 (公有成員函式)
read	擷取字元區塊 (公有成員函式)
readsome	擷取已可用的字元區塊 (公有成員函式)
gcount	回傳上次非格式化輸入操作所擷取的字元數 (公有成員函式)
定位
tellg	回傳輸入位置指示器 (公有成員函式)
seekg	設定輸入位置指示器 (公有成員函式)
其他
sync	與底層儲存裝置同步 (公有成員函式)
swap (C++11)	交換串流物件，但排除相關聯的緩衝區 (保護成員函式)

成員類別

sentry

實作串流準備進行輸入操作的基本邏輯 (公有成員類別)

非成員函式

operator>>(std::basic_istream)

提取字元與字元陣列 (函式模板)

繼承自 std::basic_ios

成員型別

成員型別	定義
char_type	CharT
traits_type	Traits
int_type	Traits::int_type
pos_type	Traits::pos_type
off_type	Traits::off_type

成員函式

狀態函式
good	檢查是否未發生錯誤，即 I/O 操作可用 (std::basic_ios<CharT,Traits> 的公開成員函式)
eof	檢查是否已到達檔案末尾 (end-of-file) (std::basic_ios<CharT,Traits> 的公開成員函式)
fail	檢查是否發生了錯誤 (std::basic_ios<CharT,Traits> 的公開成員函式)
bad	檢查是否發生了不可恢復的錯誤 (std::basic_ios<CharT,Traits> 的公開成員函式)
operator!	檢查是否發生了錯誤 (等同於 fail()) (std::basic_ios<CharT,Traits> 的公開成員函式)
operator bool	檢查是否未發生錯誤 (等同於 !fail()) (std::basic_ios<CharT,Traits> 的公開成員函式)
rdstate	回傳狀態旗標 (std::basic_ios<CharT,Traits> 的公開成員函式)
setstate	設定狀態旗標 (std::basic_ios<CharT,Traits> 的公開成員函式)
clear	修改狀態旗標 (std::basic_ios<CharT,Traits> 的公開成員函式)
格式化
copyfmt	複製格式化資訊 (std::basic_ios<CharT,Traits> 的公開成員函式)
fill	管理填充字元 (std::basic_ios<CharT,Traits> 的公開成員函式)
其他
exceptions	管理例外遮罩 (exception mask) (std::basic_ios<CharT,Traits> 的公開成員函式)
imbue	設定區域語言 (locale) (std::basic_ios<CharT,Traits> 的公開成員函式)
rdbuf	管理關聯的串流緩衝區 (std::basic_ios<CharT,Traits> 的公開成員函式)
tie	管理繫結的串流 (std::basic_ios<CharT,Traits> 的公開成員函式)
narrow	轉換為窄字元 (std::basic_ios<CharT,Traits> 的公開成員函式)
widen	轉換為寬字元 (std::basic_ios<CharT,Traits> 的公開成員函式)

繼承自 std::ios_base

成員函式

格式化
flags	管理格式旗標 (std::ios_base 的公開成員函式)
setf	設定特定的格式旗標 (std::ios_base 的公開成員函式)
unsetf	清除特定的格式旗標 (std::ios_base 的公開成員函式)
precision	管理浮點數操作的小數精確度 (std::ios_base 的公開成員函式)
width	管理欄位寬度 (std::ios_base 的公開成員函式)
在地化 (Locales)
imbue	設定區域語言 (locale) (std::ios_base 的公開成員函式)
getloc	回傳當前區域語言 (locale) (std::ios_base 的公開成員函式)
內部可擴充陣列
xalloc [靜態]	回傳一個程式範圍內唯一的整數，可安全地用作 pword() 和 iword() 的索引 (std::ios_base 的公開靜態成員函式)
iword	必要時調整私有儲存區的大小，並存取位於指定索引的 long 元素 (std::ios_base 的公開成員函式)
pword	必要時調整私有儲存區的大小，並存取位於指定索引的 void* 元素 (std::ios_base 的公開成員函式)
其他
register_callback	註冊事件回呼函式 (std::ios_base 的公開成員函式)
sync_with_stdio [靜態]	設定 C++ 與 C I/O 程式庫是否互通 (std::ios_base 的公開靜態成員函式)
成員類別
failure	串流例外 (std::ios_base 的公開成員類別)
Init	初始化標準串流物件 (std::ios_base 的公開成員類別)

成員型別與常數
類型	說明
openmode	串流開啟模式型別 亦定義了下列常數 常數 說明 app 每次寫入前先移至串流末尾 binary 以 二進位模式 開啟 in 為讀取而開啟 out 為寫入而開啟 trunc 開啟時捨棄串流內容 ate 開啟後立即移至串流末尾 noreplace (C++23) 以獨佔模式開啟 (typedef)
fmtflags	格式化旗標型別 亦定義了下列常數 常數 說明 dec 對整數 I/O 使用十進位基底：參見 std::dec oct 對整數 I/O 使用八進位基底：參見 std::oct hex 對整數 I/O 使用十六進位基底：參見 std::hex basefield dec | oct | hex。可用於遮罩操作 left 左對齊 (在右側添加填充字元)：參見 std::left right 右對齊 (在左側添加填充字元)：參見 std::right internal 內部對齊 (在內部指定點添加填充字元)：參見 std::internal adjustfield left | right | internal。可用於遮罩操作 scientific 使用科學記號法產生浮點型別，若與 fixed 結合則使用十六進位記號法：參見 std::scientific fixed 使用定點記號法產生浮點型別，若與 scientific 結合則使用十六進位記號法：參見 std::fixed floatfield scientific | fixed。可用於遮罩操作 boolalpha 以字母數字格式插入及擷取 bool 型別：參見 std::boolalpha showbase 為整數輸出產生表示數值基底的前綴，在貨幣 I/O 中要求貨幣指示器：參見 std::showbase showpoint 對浮點數輸出無條件產生小數點字元：參見 std::showpoint showpos 對非負數輸出產生 + 字元：參見 std::showpos skipws 在某些輸入操作前跳過開頭的空白字元：參見 std::skipws unitbuf 每次輸出操作後排空 (flush) 輸出：參見 std::unitbuf uppercase 在特定輸出操作中將某些小寫字母替換為其對應的大寫字母：參見 std::uppercase (typedef)
iostate	串流狀態型別 亦定義了下列常數 常數 說明 goodbit 無錯誤 badbit 不可恢復的串流錯誤 failbit 輸入/輸出操作失敗 (格式化或擷取錯誤) eofbit 關聯的輸入序列已到達檔案末尾 (end-of-file) (typedef)
seekdir	尋找方向型別 亦定義了下列常數 常數 說明 beg 串流的開頭 end 串流的末尾 cur 串流位置指示器的當前位置 (typedef)
event	指定事件型別 (enum)
event_callback	回呼函式型別 (typedef)