C++

參考

<istream>

istream

public member function
<istream> <iostream>

std::istream::readsome

streamsize readsome (char* s, streamsize n);
讀取緩衝區中可用的資料
從流中提取最多 n 個字元，並將它們儲存在 s 指向的陣列中，一旦關聯的流緩衝區物件（如果有）的內部緩衝區用盡，就會停止提取字元，即使尚未到達檔案結尾。

此函式用於從某些型別的非同步源讀取資料，這些源可能會等待更多字元，因為它一旦內部緩衝區耗盡就停止提取字元，從而避免潛在的延遲。

請注意，此函式依賴於流關聯的特定流緩衝區物件的內部機制，對於標準類來說，其行為在很大程度上是實現定義的。

內部，該函式首先透過構造一個 sentry 物件（並將 noskipws 設定為 true）來訪問輸入序列。然後（如果 good），它透過呼叫其成員函式 in_avail 來檢查當前關聯的流緩衝區物件中有多少個字元可用，並透過呼叫 sbumpc（或 sgetc）來提取最多數量的字元。最後，在返回之前銷燬 sentry 物件。

可以透過呼叫成員函式 gcount 來訪問此函式成功讀取並存儲的字元數。

引數

s
指向儲存提取字元的陣列的指標。
n
要提取的最大字元數。
streamsize 是一個帶符號整型。

返回值

儲存的字元數。
streamsize 是一個帶符號整型。

錯誤透過修改 *內部狀態標誌* 來發出訊號。
flagerror
eofbit輸入序列沒有可用的字元（由 rdbuf()->in_avail() 返回 -1 報告）。
failbit構造sentry失敗（例如，當流狀態在呼叫之前不是good時）。
badbit流錯誤（例如，當此函式捕獲由內部操作丟擲的異常時）。
設定此標誌時，流的完整性可能受到影響。
一次操作可能會設定多個標誌。

如果操作設定了一個已透過成員函式 exceptions 註冊的內部狀態標誌，則該函式會丟擲其成員型別為 failure 的異常。

資料競爭

修改 s 指向的陣列中的元素以及流物件。
對同一流物件的併發訪問可能導致資料競爭，除了標準流物件 cin 在其與 stdio 同步時。在這種情況下，不會發生資料競爭，儘管不保證提取的字元將歸屬到哪個執行緒。

異常安全

基本保證：如果丟擲異常，物件處於有效狀態。
如果結果錯誤狀態標誌不是 goodbit 並且成員函式 exceptions 被設定為針對該狀態丟擲，則該函式會丟擲其成員型別為 failure 的異常。
內部操作丟擲的任何異常都會被函式捕獲和處理，並設定 badbit。如果在最後一次呼叫 exceptions 時設定了 badbit，則該函式會重新丟擲捕獲到的異常。

另見

istream::read
讀取資料塊 (公共成員函式)
ostream::write
寫入資料塊 （公開成員函式）
istream::operator>>
提取格式化輸入 (公共成員函式)