View source for cpp/error

You do not have permission to edit this page, for the following reasons:

The action you have requested is limited to users in one of the groups: Users, Administrators.

Due to recent vandalism, editing of this page is temporarily disabled for new users.If you want to suggest a change, please leave a message on the suggestions page for new users instead (don't be surprised if that page appears vandalized!).

You can view and copy the source of this page.

{{title|Diagnostics library}}
{{cpp/error/navbar}}

===Exception handling===
The header {{header|exception}} provides several classes and functions related to exception handling in C++ programs.

{{dsc begin}}
{{dsc header|exception}}
{{dsc inc|cpp/error/dsc exception}}
{{dsc h2|Capture and storage of exception objects}}
{{dsc inc|cpp/error/dsc uncaught_exception}}
{{dsc inc|cpp/error/dsc exception_ptr}}
{{dsc inc|cpp/error/dsc make_exception_ptr}}
{{dsc inc|cpp/error/dsc current_exception}}
{{dsc inc|cpp/error/dsc rethrow_exception}}
{{dsc inc|cpp/error/dsc nested_exception}}
{{dsc inc|cpp/error/dsc throw_with_nested}}
{{dsc inc|cpp/error/dsc rethrow_if_nested}}
{{dsc h2|Handling of failures in exception handling}}
{{dsc header|exception}}
{{dsc inc|cpp/error/dsc terminate}}
{{dsc inc|cpp/error/dsc terminate_handler}}
{{dsc inc|cpp/error/dsc get_terminate}}
{{dsc inc|cpp/error/dsc set_terminate}}
{{dsc inc|cpp/error/dsc bad_exception}}
{{anchor|Handling of exception specification violations}}
{{dsc h2|Handling of exception specification violations {{mark until c++17}}}}
{{dsc inc|cpp/error/dsc unexpected}}
{{dsc inc|cpp/error/dsc unexpected_handler}}
{{dsc inc|cpp/error/dsc get_unexpected}}
{{dsc inc|cpp/error/dsc set_unexpected}}
{{dsc end}}

===Exception categories===
Several convenience classes are predefined in the header {{tt|<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.

{{dsc begin}}
{{dsc header|stdexcept}}
{{dsc inc|cpp/error/inc logic_error}}
{{dsc inc|cpp/error/inc invalid_argument}}
{{dsc inc|cpp/error/inc domain_error}}
{{dsc inc|cpp/error/inc length_error}}
{{dsc inc|cpp/error/inc out_of_range}}
{{dsc inc|cpp/error/inc runtime_error}}
{{dsc inc|cpp/error/inc range_error}}
{{dsc inc|cpp/error/inc overflow_error}}
{{dsc inc|cpp/error/inc underflow_error}}
{{dsc tclass|cpp/error/tx_exception|exception class to cancel atomic transactions|notes={{mark since tm ts}}}}
{{dsc end}}

===Error numbers===
{{dsc begin}}
{{dsc header|cerrno}}
{{dsc inc|cpp/error/dsc errno}}
{{dsc inc|cpp/error/dsc errno_macros}}
{{dsc end}}

{{anchor|System error}}
===System error {{mark since c++11}}===
The header {{tt|<system_error>}} defines types and functions used to report error conditions originating from the operating system, streams I/O, {{lc|std::future}}, or other low-level APIs.

{{dsc begin}}
{{dsc header|system_error}}
{{dsc inc|cpp/error/dsc error_category}}
{{dsc inc|cpp/error/dsc generic_category}}
{{dsc inc|cpp/error/dsc system_category}}
{{dsc inc|cpp/error/dsc error_condition}}
{{dsc inc|cpp/error/dsc errc}}
{{dsc inc|cpp/error/dsc error_code}}
{{dsc inc|cpp/error/dsc system_error}}
{{dsc end}}

===Assertions===
Assertions help to implement checking of preconditions in programs.

{{dsc begin}}
{{dsc header|cassert}}
{{dsc inc|cpp/error/dsc assert}}
{{dsc end}}

{{anchor|Stacktrace}}
===[[cpp/utility/basic_stacktrace|Stacktrace]] {{mark since c++23}}===
{{dsc begin}}
{{dsc header|stacktrace}}
{{dsc inc|cpp/utility/dsc stacktrace_entry}}
{{dsc inc|cpp/utility/dsc basic_stacktrace}}
{{dsc end}}

{{anchor|Debugging support}}
===Debugging support {{mark since c++26}}===
{{dsc begin}}
{{dsc header|debugging}}
{{dsc inc|cpp/utility/dsc breakpoint}}
{{dsc inc|cpp/utility/dsc breakpoint_if_debugging}}
{{dsc inc|cpp/utility/dsc is_debugger_present}}
{{dsc end}}

===See also===
{{dsc begin}}
{{dsc inc|cpp/language/dsc static_assert}}
{{dsc see c|c/error|Error handling|nomono=true}}
{{dsc end}}

{{langlinks|de|es|fr|it|ja|pt|ru|zh}}

Templates used on this page:

Template:! (view source) (protected)
Template:anchor (view source)
Template:c (view source) (protected)
Template:cpp/error/dsc assert (view source)
Template:cpp/error/dsc bad exception (view source)
Template:cpp/error/dsc current exception (view source)
Template:cpp/error/dsc errc (view source)
Template:cpp/error/dsc errno (view source)
Template:cpp/error/dsc errno macros (view source)
Template:cpp/error/dsc error category (view source)
Template:cpp/error/dsc error code (view source)
Template:cpp/error/dsc error condition (view source)
Template:cpp/error/dsc exception (view source)
Template:cpp/error/dsc exception ptr (view source)
Template:cpp/error/dsc generic category (view source)
Template:cpp/error/dsc get terminate (view source)
Template:cpp/error/dsc get unexpected (view source)
Template:cpp/error/dsc make exception ptr (view source)
Template:cpp/error/dsc nested exception (view source)
Template:cpp/error/dsc rethrow exception (view source)
Template:cpp/error/dsc rethrow if nested (view source)
Template:cpp/error/dsc set terminate (view source)
Template:cpp/error/dsc set unexpected (view source)
Template:cpp/error/dsc system category (view source)
Template:cpp/error/dsc system error (view source)
Template:cpp/error/dsc terminate (view source)
Template:cpp/error/dsc terminate handler (view source)
Template:cpp/error/dsc throw with nested (view source)
Template:cpp/error/dsc uncaught exception (view source)
Template:cpp/error/dsc unexpected (view source)
Template:cpp/error/dsc unexpected handler (view source)
Template:cpp/error/inc domain error (view source)
Template:cpp/error/inc invalid argument (view source)
Template:cpp/error/inc length error (view source)
Template:cpp/error/inc logic error (view source)
Template:cpp/error/inc out of range (view source)
Template:cpp/error/inc overflow error (view source)
Template:cpp/error/inc range error (view source)
Template:cpp/error/inc runtime error (view source)
Template:cpp/error/inc underflow error (view source)
Template:cpp/error/navbar (view source)
Template:cpp/error/navbar content (view source)
Template:cpp/error/navbar heading (view source)
Template:cpp/language/dsc static assert (view source)
Template:cpp/navbar content (view source)
Template:cpp/navbar heading (view source)
Template:cpp/utility/dsc basic stacktrace (view source)
Template:cpp/utility/dsc breakpoint (view source)
Template:cpp/utility/dsc breakpoint if debugging (view source)
Template:cpp/utility/dsc is debugger present (view source)
Template:cpp/utility/dsc stacktrace entry (view source)
Template:dcl list header/link (view source)
Template:dsc (view source) (protected)
Template:dsc begin (view source) (protected)
Template:dsc class (view source) (protected)
Template:dsc editlink (view source)
Template:dsc end (view source) (protected)
Template:dsc fun (view source) (protected)
Template:dsc guard (view source) (protected)
Template:dsc h2 (view source) (protected)
Template:dsc header (view source) (protected)
Template:dsc header/link (view source)
Template:dsc inc (view source) (protected)
Template:dsc macro const (view source) (protected)
Template:dsc macro fun (view source) (protected)
Template:dsc member (view source) (protected)
Template:dsc see c (view source)
Template:dsc tclass (view source) (protected)
Template:dsc tfun (view source) (protected)
Template:dsc typedef (view source) (protected)
Template:get lang (view source) (protected)
Template:header (view source)
Template:langlinks (view source) (protected)
Template:langlinks/one (view source) (protected)
Template:lc (view source) (protected)
Template:lines (view source) (protected)
Template:ls (view source)
Template:ltt (view source) (protected)
Template:ltt/core (view source) (protected)
Template:mark (view source) (protected)
Template:mark c++11 (view source) (protected)
Template:mark c++17 (view source) (protected)
Template:mark c++20 (view source)
Template:mark c++23 (view source) (protected)
Template:mark c++26 (view source)
Template:mark class (view source) (protected)
Template:mark deprecated c++11 (view source)
Template:mark fun (view source) (protected)
Template:mark life (view source)
Template:mark macro const (view source) (protected)
Template:mark macro fun (view source) (protected)
Template:mark rev (view source) (protected)
Template:mark since c++11 (view source) (protected)
Template:mark since c++23 (view source)
Template:mark since c++26 (view source)
Template:mark since tm ts (view source)
Template:mark tclass (view source)
Template:mark tfun (view source) (protected)
Template:mark tooltip (view source)
Template:mark typedef (view source) (protected)
Template:mark until c++17 (view source)
Template:navbar (view source)
Template:navbar editlink (view source) (protected)
Template:nbsp (view source) (protected)
Template:nbspt (view source)
Template:nv (view source) (protected)
Template:nv begin (view source) (protected)
Template:nv col begin (view source) (protected)
Template:nv col end (view source) (protected)
Template:nv col next (view source) (protected)
Template:nv end (view source) (protected)
Template:nv h2 (view source) (protected)
Template:nv ln (view source) (protected)
Template:title (view source) (protected)
Template:tooltip (view source)
Template:trim (view source) (protected)
Template:tt (view source) (protected)

Return to cpp/error.

cppreference.com

Search

Namespaces

Variants

Views

Actions

View source for cpp/error

Navigation

Tools