Developer Reference for Intel® oneAPI Math Kernel Library for C
?lascl
Multiplies a general rectangular matrix by a real scalar defined as c to /c from .
Syntax
lapack_intLAPACKE_slascl ( intmatrix_layout , chartype , lapack_intkl , lapack_intku , floatcfrom , floatcto , lapack_intm , lapack_intn , float*a , lapack_intlda );
lapack_intLAPACKE_dlascl ( intmatrix_layout , chartype , lapack_intkl , lapack_intku , doublecfrom , doublecto , lapack_intm , lapack_intn , double*a , lapack_intlda );
lapack_intLAPACKE_clascl ( intmatrix_layout , chartype , lapack_intkl , lapack_intku , floatcfrom , floatcto , lapack_intm , lapack_intn , lapack_complex_float*a , lapack_intlda );
lapack_intLAPACKE_zlascl ( intmatrix_layout , chartype , lapack_intkl , lapack_intku , doublecfrom , doublecto , lapack_intm , lapack_intn , lapack_complex_double*a , lapack_intlda );
Include Files
mkl.h
Description
slascl dlascl clascl zlascl
The routine ?lascl multiplies the m -by- n real/complex matrix A by the real scalar c_{to}/c_{from} . The operation is performed without over/underflow as long as the final result c_{to}*A(i,j)/c_{from} does not over/underflow.
type specifies that A may be full, upper triangular, lower triangular, upper Hessenberg, or banded.
Input Parameters
- matrix_layout
-
Specifies whether matrix storage layout is row major ( LAPACK_ROW_MAJOR ) or column major ( LAPACK_COL_MAJOR ).
type
This parameter specifies the storage type of the input matrix.
= ‘G’ : A is a full matrix. = ‘L’ : A is a lower triangular matrix. = ‘U’ : A is an upper triangular matrix. = ‘H’ : A is an upper Hessenberg matrix. = ‘B’ : A is a symmetric band matrix with lower bandwidth kl and upper bandwidth ku and with the only the lower half stored = ‘Q’ : A is a symmetric band matrix with lower bandwidth kl and upper bandwidth ku and with the only the upper half stored. = ‘Z’ : A is a band matrix with lower bandwidth kl and upper bandwidth ku . See description of the ?gbtrf function for storage details.
kl
The lower bandwidth of A . Referenced only if type = 'B' , ‘Q’ or ‘Z’ .
ku
The upper bandwidth of A . Referenced only if type = 'B' , ‘Q’ or ‘Z’ .
- cfrom , cto
-
REAL for slascl / clascl DOUBLE PRECISION for dlascl / zlascl The matrix A is multiplied by cto / cfrom . A(i,j) is computed without over/underflow if the final result cto*A(i,j)/cfrom can be represented without over/underflow. cfrom must be nonzero.
m
The number of rows of the matrix A . m≥ 0 .
n
The number of columns of the matrix A . n ≥ 0.
- a
-
REAL for slascl DOUBLE PRECISION for dlascl COMPLEX for clascl DOUBLE COMPLEX for zlascl
Array, size ( lda * n ) . The matrix to be multiplied by cto / cfrom . See type for the storage type.
lda
The leading dimension of the array a .
lda≥ max(1,m) .
Output Parameters
- a
-
The multiplied matrix A .
info
INTEGER .
If info = 0 - successful exit
If info = -i < 0 , the i -th argument had an illegal value.