C++

參考

<ios>

basic_ios

public member function
<ios> <iostream>

std::basic_ios::setstate

void setstate (iostate state);
設定錯誤狀態標誌
透過將當前標誌與引數 state 中的標誌組合（如同執行按位或運算）來修改當前內部的錯誤狀態標誌。

任何已設定的錯誤位標誌都不會被清除。請參閱成員 clear 以瞭解一個具有類似功能的函式。

如果在呼叫此函式時，流沒有關聯的流緩衝區，則 badbit 標誌會自動設定（無論在引數 state 中傳遞的該位的值是什麼）。

請注意，根據傳遞給成員 exceptions 的最新設定，更改 state 可能會丟擲異常。

當前狀態可以透過成員函式 rdstate 獲取。

此函式行為如同定義為
1
2
3
 
void basic_ios::setstate (iostate state) {
  clear(rdstate()|state);
}

引數

state
一個 ios_base::iostate 型別的物件，它可以接受以下成員常量的任何組合作為值

iostate 值
(成員常量)		表示檢查狀態標誌的函式
good()eof()fail()bad()rdstate()
goodbit無錯誤（值為零 iostate）truefalsefalsefalsegoodbit
eofbit到達檔案尾falsetruefalsefalseeofbit
failbitI/O 操作的邏輯錯誤falsefalsetruefalsefailbit
badbitI/O 操作的讀/寫錯誤falsefalsetruetruebadbit
eofbit、failbit 和 badbit 是具有實現定義值的成員常量，可以進行組合（就像使用按位 OR 運算子一樣）。
goodbit 為零，表示其他位均未設定。

返回值

無

資料競爭

修改流物件。
併發訪問同一個流物件可能導致資料爭用。

異常安全

基本保證：如果丟擲異常，流處於有效狀態。
如果由此產生的錯誤狀態標誌不是 goodbit，並且成員 exceptions 已被設定為針對該狀態丟擲，則它將丟擲成員型別為 failure 的異常。

另見

basic_ios::fail
檢查 failbit 或 badbit 是否已設定 (public member function)
basic_ios::good
檢查流狀態是否良好 （公開成員函式）
basic_ios::bad
檢查是否設定了 badbit （公開成員函式）
basic_ios::eof
檢查是否設定了 eofbit （公開成員函式）
basic_ios::rdstate
獲取錯誤狀態標誌 （公開成員函式）
basic_ios::clear
設定錯誤狀態標誌 （公開成員函式）