cppreference.com

Namespaces

Variants

Actions

Diagnostics library

From cppreference.com

< cpp

Compiler support

Freestanding and hosted

Standard library

Standard library headers

Named requirements

Feature test macros (C++20)

Language support library

Concepts library (C++20)

Diagnostics library

Memory management library

Metaprogramming library (C++11)

General utilities library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Strings library

Text processing library

Numerics library

Date and time library

Input/output library

Filesystem library (C++17)

Concurrency support library (C++11)

Execution control library (C++26)

Technical specifications

External libraries

Diagnostics library

Exception handling

uncaught_exceptionuncaught_exceptions

(until C++20*) (C++17)

(C++11)

make_exception_ptr

(C++11)

current_exception

(C++11)

rethrow_exception

(C++11)

nested_exception

(C++11)

throw_with_nested

(C++11)

rethrow_if_nested

(C++11)

Exception handling failures

terminate_handler

(C++11)

(until C++17*)

unexpected_handler

(until C++17*)

(until C++17*)

(until C++17*)

Exception categories

invalid_argument

underflow_error

(TM TS)

(C++11)

generic_category

(C++11)

system_category

(C++11)

error_condition

(C++11)

(C++11)

(C++11)

(C++11)

stacktrace_entry

(C++23)

basic_stacktrace

(C++23)

Debugging support

is_debugger_present

(C++26)

breakpoint_if_debugging

(C++26)

(C++26)

Contents

[edit] Exception handling

The header <exception> provides several classes and functions related to exception handling in C++ programs.

Defined in header <exception>

base class for exceptions thrown by the standard library components
(class) [edit]

Capture and storage of exception objects

uncaught_exceptionuncaught_exceptions

(removed in C++20*)(C++17)

checks if exception handling is currently in progress
(function) [edit]

(C++11)

shared pointer type for handling exception objects
(typedef) [edit]

make_exception_ptr

(C++11)

creates an std::exception_ptr from an exception object
(function template) [edit]

current_exception

(C++11)

captures the current exception in a std::exception_ptr
(function) [edit]

rethrow_exception

(C++11)

throws the exception from an std::exception_ptr
(function) [edit]

nested_exception

(C++11)

a mixin type to capture and store current exceptions
(class) [edit]

throw_with_nested

(C++11)

throws its argument with std::nested_exception mixed in
(function template) [edit]

rethrow_if_nested

(C++11)

throws the exception from a std::nested_exception
(function template) [edit]

Handling of failures in exception handling

Defined in header <exception>

function called when exception handling fails
(function) [edit]

terminate_handler

the type of the function called by std::terminate
(typedef) [edit]

(C++11)

obtains the current terminate_handler
(function) [edit]

changes the function to be called by std::terminate
(function) [edit]

exception thrown when std::current_exception fails to copy the exception object
(class) [edit]

Handling of exception specification violations (until C++17)

(deprecated in C++11)(removed in C++17)

function called when dynamic exception specification is violated
(function) [edit]

unexpected_handler

(deprecated in C++11)(removed in C++17)

the type of the function called by std::unexpected
(typedef) [edit]

(deprecated in C++11)(removed in C++17)

obtains the current unexpected_handler
(function) [edit]

(deprecated in C++11)(removed in C++17)

changes the function to be called by std::unexpected
(function) [edit]

[edit] Exception categories

Several convenience classes are predefined in the header <stdexcept> to report particular error conditions. These classes can be divided into two categories: logic errors and runtime errors. Logic errors are a consequence of faulty logic within the program and may be preventable. Runtime errors are due to events beyond the scope of the program and cannot easily be predicted.

Defined in header <stdexcept>

exception class to indicate violations of logical preconditions or class invariants
(class) [edit]

invalid_argument

exception class to report invalid arguments
(class) [edit]

exception class to report domain errors
(class) [edit]

exception class to report attempts to exceed maximum allowed size
(class) [edit]

exception class to report arguments outside of expected range
(class) [edit]

exception class to indicate conditions only detectable at run time
(class) [edit]

exception class to report range errors in internal computations
(class) [edit]

exception class to report arithmetic overflows
(class) [edit]

underflow_error

exception class to report arithmetic underflows
(class) [edit]

(TM TS)

exception class to cancel atomic transactions
(class template)

[edit] Error numbers

Defined in header <cerrno>

macro which expands to POSIX-compatible thread-local error number variable
(macro variable)[edit]

E2BIG, EACCES, ..., EXDEV

macros for standard POSIX-compatible error conditions
(macro constant) [edit]

[edit] System error (since C++11)

The header <system_error> defines types and functions used to report error conditions originating from the operating system, streams I/O, std::future , or other low-level APIs.

Defined in header <system_error>

(C++11)

base class for error categories
(class) [edit]

generic_category

(C++11)

identifies the generic error category
(function) [edit]

system_category

(C++11)

identifies the operating system error category
(function) [edit]

error_condition

(C++11)

holds a portable error code
(class) [edit]

(C++11)

the std::error_condition enumeration listing all standard <cerrno> macro constants
(class) [edit]

(C++11)

holds a platform-dependent error code
(class) [edit]

(C++11)

exception class used to report conditions that have an error_code
(class) [edit]

[edit] Assertions

Assertions help to implement checking of preconditions in programs.

Defined in header <cassert>

aborts the program if the user-specified condition is not true. May be disabled for release builds.
(function macro) [edit]

[edit] Stacktrace (since C++23)

Defined in header <stacktrace>

stacktrace_entry

(C++23)

representation of an evaluation in a stacktrace
(class) [edit]

basic_stacktrace

(C++23)

approximate representation of an invocation sequence consists of stacktrace entries
(class template) [edit]

[edit] Debugging support (since C++26)

Defined in header <debugging>

(C++26)

pauses the running program when called
(function) [edit]

breakpoint_if_debugging

(C++26)

calls std::breakpoint if std::is_debugger_present returns true
(function) [edit]

is_debugger_present

(C++26)

checks whether a program is running under the control of a debugger
(function) [edit]

[edit] See also

static_assert declaration (C++11) performs compile-time assertion checking[edit]

C documentation for Error handling

Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/error&oldid=179907"