std::io_errc(3)

💖 NAME 💖

okay bestie, welcome to std::io_errc — yes, the std::io_errc(3) page from the C++ Standard Libary manual 💅

std::io_errc — literally std::io_errc. That's the name, no cap 🎀

---

✨ Synopsis ✨

It lives in header <ios>:

enum class io_errc {

    stream = 1,          (since C++11)

};

The scoped enumeration std::io_errc defines the error codes reported by I/O streams in std::ios_base::failure exception objects. Only one error code (std::io_errc::stream) is required, although the implementation may define additional error codes. Because the appropriate specialization of std::is_error_code_enum is provided, values of type std::io_errc are implicitly convertible to std::error_code 🦋

lowkey important: only std::io_errc::stream is guaranteed, but implementations are allowed to add extra codes. iykyk 💀

---

🧮 Member constants 🧮

• Enumeration constant: stream
• Value: 1

that's the whole lil' constants vibe, bestie ✨

---

🛠️ Non-member functions 🛠️

• make_error_code(std::io_errc) — constructs an iostream error code (function) (C++11) 🫶
• make_error_condition(std::io_errc) — constructs an iostream error condition (function) (C++11) 💜

---

🧸 Helper classes 🧸

• is_error_code_enum<std::io_errc> — extends the type trait std::is_error_code_enum to identify iostream error codes (class template specialization) (C++11) 🌸

---

🍓 Example 🍓

run this code, bestie:

// Run this code

#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";
    }
}

---

🌈 Output 🌈

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

ate, no crumbs 👑

---

👀 See also 👀

• error_code — holds a platform-dependent error code (C++11) (class) 🔥
• error_condition — holds a portable error code (C++11) (class) ⭐
• failure — stream exception (public member class of std::ios_base) 💖

---

mwah 💋 — source: http://cppreference.com, date/version: 2024.06.10, for std::io_errc(3) in the C++ Standard Libary. periodt. 💅