std::basic_ios<CharT,Traits>::clear

 

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_ios

成員函式

basic_ios::basic_ios

basic_ios::~basic_ios

狀態函式

basic_ios::good

basic_ios::eof

basic_ios::fail

basic_ios::bad

basic_ios::operator!

basic_ios::operator bool

basic_ios::rdstate

basic_ios::setstate

basic_ios::clear

格式化

basic_ios::copyfmt

basic_ios::fill

雜項

basic_ios::exceptions

basic_ios::imbue

basic_ios::rdbuf

basic_ios::tie

basic_ios::narrow

basic_ios::widen

受保護的成員函式

basic_ios::init

basic_ios::move (C++11)

basic_ios::swap (C++11)

basic_ios::set_rdbuf (C++11)

 

void clear( std::ios_base::iostate state = std::ios_base::goodbit );

透過將流錯誤狀態標誌賦值為 state 的值來設定它們。預設情況下，賦值為 std::ios_base::goodbit，這將清除所有錯誤狀態標誌。

如果 rdbuf() 是空指標（即沒有關聯的流緩衝區），則賦值為 state | std::ios_base::badbit。

引數

state

-

新的錯誤狀態標誌設定。它可以是以下常量的組合 常量 解釋 goodbit 無錯誤 badbit 不可恢復的流錯誤 failbit 輸入/輸出操作失敗（格式化或提取錯誤） eofbit 關聯的輸入序列已到達檔案末尾

返回值

(無)

異常

如果新的錯誤狀態包含的位也包含在 exceptions() 掩碼中，則丟擲型別為 failure 的異常。

示例

不帶引數的 clear() 可用於在意外輸入後取消設定 failbit；對於 std::cin.putback(c)，請參閱 ungetc。

執行此程式碼

#include <iostream>
#include <string>
 
int main()
{
    for (char c : {'\n', '4', '1', '.', '3', '\n', 'Z', 'Y', 'X'})
        std::cin.putback(c); // emulate user's input (not portable: see ungetc Notes)
 
    double n;
    while (std::cout << "Please, enter a number: " && !(std::cin >> n))
    {
        std::cin.clear();
        std::string line;
        std::getline(std::cin, line);
        std::cout << line << "\nI am sorry, but '" << line << "' is not a number\n";
    }
    std::cout << n << "\nThank you for entering the number " << n << '\n';
}

輸出

Please, enter a number: XYZ
I am sorry, but 'XYZ' is not a number
Please, enter a number: 3.14
Thank you for entering the number 3.14

缺陷報告

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

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 412	C++98	如果當前錯誤狀態 包含的位也包含在 exceptions() 掩碼中，則會丟擲異常	檢查新的 錯誤狀態

另請參閱

setstate	設定狀態標誌 (公共成員函式)
rdstate	返回狀態標誌 (公共成員函式)