.. _oneapi-mkl-sparse-release_matmat_descr:

oneapi::mkl::sparse::release_matmat_descr
=========================================

Releases  ``oneapi::mkl::sparse::matmat_descr_t`` object and sets it to NULL.


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

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

The ``oneapi::mkl::sparse::release_matmat_descr`` routine releases
the ``oneapi::mkl::sparse::matmat_descr_t`` object and sets it to NULL.

A common usage model for the ``matmat`` descriptor is the following

.. code-block:: cpp

    using namespace oneapi::mkl;
    sparse::matmat_descr_t descr = NULL;
    sparse::init_matmat_descr(descr);

    // example descriptor for general
    // C = A * B
    sparse::matrix_view_descr viewA = sparse::matrix_view_descr::general;
    sparse::matrix_view_descr viewB = sparse::matrix_view_descr::general;
    sparse::matrix_view_descr viewC = sparse::matrix_view_descr::general;
    transpose opA = transpose::nontrans;
    transpose opB = transpose::nontrans;

    sparse::set_matmat_data(descr, viewA, opA, viewB, opB, viewC);

    // use descr in sparse::matmat() api

    sparse::release_matmat_descr(descr);


API
***

Syntax
------

.. code-block:: cpp

    namespace oneapi::mkl::sparse {
        void release_matmat_descr ( oneapi::mkl::sparse::matmat_descr_t *descr );
    }



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

-  oneapi/mkl/spblas.hpp