.. _exceptions:

Exceptions
==========

|O-MKL| Sparse BLAS DPC++ APIs may throw any of the following exceptions, which extend ``std::runtime_error`` exception class.  See ``include/oneapi/mkl/spblas.hpp`` for exception declarations.

.. list-table::
   :header-rows: 1

   * -  Exception
     -  Description
   * -  ``oneapi::mkl::sparse::not_initialized_exception()``
     -  The routine encountered an empty handle or matrix array.
   * -  ``oneapi::mkl::sparse::allocation_failed_exception()``
     -  Internal memory allocation failed.
   * -  ``oneapi::mkl::sparse::invalid_value_exception()``
     -  The input parameters contain an invalid value.
   * -  ``oneapi::mkl::sparse::execution_failed_exception()``
     -  Execution failed.
   * -  ``oneapi::mkl::sparse::internal_error_exception()``
     -  An error in algorithm implementation occurred.
   * -  ``oneapi::mkl::sparse::not_supported_exception()``
     -  The requested operation is not supported.