std::io_errc

 

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::io_errc

非成員函式

make_error_code(std::io_errc) (C++11)

make_error_condition(std::io_errc) (C++11)

輔助類

is_error_code_enum<std::io_errc> (C++11)

 

定義於標頭檔案 <ios>
enum class io_errc {     stream = 1, };		(C++11 起)

作用域列舉 std::io_errc 定義了 I/O 流在 std::ios_base::failure 異常物件中報告的錯誤程式碼。只要求一個錯誤程式碼 (std::io_errc::stream)，儘管實現可以定義額外的錯誤程式碼。由於提供了 std::is_error_code_enum 的適當特化，型別為 std::io_errc 的值可以隱式轉換為 std::error_code。

成員常量

列舉常量	值
stream	1

非成員函式

make_error_code(std::io_errc) (C++11)	構造一個 iostream 錯誤碼 (函式)
make_error_condition(std::io_errc) (C++11)	構造一個 iostream 錯誤條件 (函式)

輔助類

is_error_code_enum<std::io_errc> (C++11)

擴充套件型別特徵 std::is_error_code_enum 以識別 iostream 錯誤程式碼 (類模板特化)

示例

執行此程式碼

#include <fstream>
#include <iostream>
 
int main()
{
    std::ifstream f("doesn't exist");
    try
    {
        f.exceptions(f.failbit);
    }
    catch (const std::ios_base::failure& e)
    {
        std::cout << "Caught an ios_base::failure.\n";
        if (e.code() == std::io_errc::stream)
            std::cout << "The error code is std::io_errc::stream\n";
    }
}

輸出

Caught an ios_base::failure.
The error code is std::io_errc::stream

另請參閱

error_code (C++11)	儲存平臺相關錯誤碼 (類)
error_condition (C++11)	儲存可移植錯誤碼 (類)
failure	流異常 (std::ios_base 的公共成員類)