.. _oneapi-mkl-sparse-init_matrix_handle:

oneapi::mkl::sparse::init_matrix_handle
=======================================

Initializes a ``oneapi::mkl::sparse::matrix_handle_t`` object to default
values.


.. contents::
    :local:
    :depth: 1

Description
***********

The ``oneapi::mkl::sparse::init_matrix_handle`` function initializes
the ``oneapi::mkl::sparse::matrix_handle_t`` object with default
values, otherwise it throws an exception.

.. note::
   Refer to :ref:`Exceptions <exceptions>` for a detailed description of the exceptions thrown.


API
***

Syntax
------

.. code-block:: cpp

    namespace oneapi::mkl::sparse {
        void init_matrix_handle (
            oneapi::mkl::sparse::matrix_handle_t *handle)
    }



Include Files
-------------

-  oneapi/mkl/spblas.hpp