Intel® Math Kernel Library 2019 Developer Reference - C

mkl_sparse_?_update_values

Changes all or selected matrix values in internal representation.

Syntax

Note

This routine is supported for sparse matrices in BSR format only.

sparse_status_t mkl_sparse_s_update_values (sparse_matrix_t A, MKL_INT nvalues, MKL_INT *indx, MKL_INT *indy, float *values);

sparse_status_t mkl_sparse_d_update_values (sparse_matrix_t A, MKL_INT nvalues, MKL_INT *indx, MKL_INT *indy, double *values);

sparse_status_t mkl_sparse_c_update_values (sparse_matrix_t A, MKL_INT nvalues, MKL_INT *indx, MKL_INT *indy, MKL_Complex8 *values);

sparse_status_t mkl_sparse_z_update_values (sparse_matrix_t A, MKL_INT nvalues, MKL_INT *indx, MKL_INT *indy, MKL_Complex16 *values);

Include Files

Description

Use the mkl_sparse_?_update_values routine to change all or selected values of a matrix in the internal Inspector-Executor Sparse BLAS format.

The values to be updated should already be present in the matrix structure.

Input Parameters

A

Specifies handle containing internal data.

nvalues

Total number of elements changed.

indx

Row indices for the new values.

indy

Column indices for the new values.

values

New values.

Output Parameters

A

Handle containing modified internal data.

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.