Error Handling

oneDTL error handling relies on the mechanism of C++ exceptions. Should an error occur, it must be propagated at the point of a function call where it must be caught using standard C++ exception handling mechanism.

Exception Classification

Exception classification in oneDTL is aligned with C++ Standard Library classification. oneDTL implementation must introduce class that defines the base class in the hierarchy of oneDTL exception classes. All other exception classes must be derived from the base class.

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

Common Exceptions

Exception class



Abstract class, base for all other oneDTL exception classes


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


Abstract class, base for all oneDTL 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 oneDTL 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