Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
mkl_sparse_?_set_value
Changes a single value of matrix in internal representation.
Syntax
stat = mkl_sparse_s_set_value ( A, row, col, value );
stat = mkl_sparse_d_set_value ( A, row, col, value );
stat = mkl_sparse_c_set_value ( A, row, col, value );
stat = mkl_sparse_z_set_value ( A, row, col, value );
Include Files
mkl_spblas.f90
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
SPARSE_MATRIX_T.
Handle containing internal data to be modified.
row
C_INT .
Indicates row of matrix in which to set value.
col
C_INT .
Indicates column of matrix in which to set value.
value
C_FLOAT |
for mkl_sparse_s_set_value |
C_DOUBLE |
for mkl_sparse_d_set_value |
C_FLOAT_COMPLEX |
for mkl_sparse_c_set_value |
C_DOUBLE_COMPLEX |
for mkl_sparse_z_set_value |
Indicates value to set in matrix at (row, col).
Output Parameters
- A
-
SPARSE_MATRIX_T. Handle containing internal data.
stat
INTEGER
Value indicating whether the operation was successful, and if not, 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. |
Return Values
See Output Parameter, stat.