Exception Classification

Exception classification in oneIPL is aligned with C++ Standard Library classification. oneIPL introduces class that defines the base class in the hierarchy of oneIPL exception classes. All oneIPL routines throw exceptions inherited from this base class. In the hierarchy of oneIPL exceptions, oneapi::ipl::exception is the base class. All other oneIPL exception classes are derived from this base class and from std::exception class (or one of its child classes).

This specification does not require implementations to perform error-checking. However, if an implementation does provide error-checking, it shall use the following exception classes. Additional implementation-specific exception classes inherited from base class can be used for exceptional conditions not fitting any of these classes.

Common exceptions

Exception class



Abstract class, base for all other oneIPL exception classes


Abstract class, base for all oneIPL exception classes on logic errors (that are a consequence of faulty logic within the program)


Abstract class, base for all oneIPL exception classes on runtime errors (that are due to events beyond the scope of the program)


Reports a problem when arguments to the routine were rejected


Reports a problem when inputs are outside of the domain on which an operation is defined


Reports a problem when there is an attempt to access element(s) out of defined range


Reports a problem when a result of a computation cannot be represented by the destination type


Base class for all oneIPL exception classes for bad allocation errors, reports a problem when an allocation function has failed to allocate storage


Reports a problem that occurred during memory allocation on the host


Reports a problem that occurred during memory allocation on a specific device


Reports a problem when the routine is not supported on a specific device


Reports a problem when a specific routine has not been implemented for the specified parameters


Reports a problem when an object has not been initialized