mkl_sparse_?_set

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 4/28/2026

Version

Public

mkl_sparse_?_set_value

Changes a single value of matrix in internal representation.

Syntax

sparse_status_t mkl_sparse_s_set_value ( const sparse_matrix_t A,
                                         const MKL_INT row,
                                         const MKL_INT col,
                                         const float value );

sparse_status_t mkl_sparse_d_set_value ( const sparse_matrix_t A,
                                         const MKL_INT row,
                                         const MKL_INT col,
                                         const double value );

sparse_status_t mkl_sparse_c_set_value ( const sparse_matrix_t A,
                                         const MKL_INT row,
                                         const MKL_INT col,
                                         const MKL_Complex8 value );

sparse_status_t mkl_sparse_z_set_value ( const sparse_matrix_t A,
                                         const MKL_INT row,
                                         const MKL_INT col,
                                         const MKL_Complex16 value );

Include Files

mkl_spblas.h

Description

Use the mkl_sparse_?_set_value routine to change a single value of a matrix in the internal representation of the sparse matrix handle. The value should already be present in a matrix structure. The routine will not add new non-zero values to the matrix, but will only change existing values. The routine will return an error if the value being set is not already present in the matrix structure.

Input Parameters

A

Handle containing internal data to be modified.

row

Indicates row of matrix in which to set value.

col

Indicates column of matrix in which to set value.

value

Indicates value to set in matrix at (row, col).

Output Parameters

Return Values

The function returns a value indicating whether the operation was successful or not, and why.

`SPARSE_STATUS_SUCCESS`	The operation was successful.
`SPARSE_STATUS_NOT_INITIALIZED`	The routine encountered an empty handle or matrix array.
`SPARSE_STATUS_ALLOC_FAILED`	Internal memory allocation failed.
`SPARSE_STATUS_INVALID_VALUE`	The input parameters contain an invalid value.
`SPARSE_STATUS_EXECUTION_FAILED`	Execution failed.
`SPARSE_STATUS_INTERNAL_ERROR`	An error in algorithm implementation occurred.
`SPARSE_STATUS_NOT_SUPPORTED`	The requested operation is not supported.

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in