?lansy

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 4/28/2026

Version

Public

?lansy

Returns the value of the 1-norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of a real/complex symmetric matrix.

Syntax

floatLAPACKE_slansy ( intmatrix_layout , charnorm , charuplo , lapack_intn , constfloat*a , lapack_intlda );

doubleLAPACKE_dlansy ( intmatrix_layout , charnorm , charuplo , lapack_intn , constdouble*a , lapack_intlda );

floatLAPACKE_clansy ( intmatrix_layout , charnorm , charuplo , lapack_intn , constlapack_complex_float*a , lapack_intlda );

doubleLAPACKE_zlansy ( intmatrix_layout , charnorm , charuplo , lapack_intn , constlapack_complex_double*a , lapack_intlda );

Include Files

mkl.h

Description

slansy dlansy clansy zlansy

The function ?lansy returns the value of the 1-norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of a real/complex symmetric matrix A .

Input Parameters

A <datatype> placeholder, if present, is used for the C interface data types in the C interface section above. See C Interface Conventions for the C interface principal conventions and type definitions.

norm

Specifies the value to be returned by the routine:

= ‘M’ or ‘m’: val = max(abs(A_{ij})) , largest absolute value of the matrix A . = ‘1’ or ‘O’ or ‘o’: val = norm1(A) , 1-norm of the matrix A (maximum column sum), = ‘I’ or ‘i’: val = normI(A) , infinity norm of the matrix A (maximum row sum), = ‘F’ , ‘f’ , ‘E’ or ‘e’: val = normF(A) , Frobenius norm of the matrix A (square root of sum of squares).

uplo: CHARACTER*1 . Specifies whether the upper or lower triangular part of the symmetric matrix A is to be referenced. = ‘U’ : Upper triangular part of A is referenced. = ‘L’ : Lower triangular part of A is referenced

n

The order of the matrix A . n≥ 0 . When n = 0 , ?lansy is set to zero.

a

REAL for slansy DOUBLE PRECISION for dlansy COMPLEX for clansy DOUBLE COMPLEX for zlansy

Array, size at least max(1, lda * n ) . The symmetric matrix A .

If uplo = 'U' , the leading n -by- n upper triangular part of a contains the upper triangular part of the matrix A , and the strictly lower triangular part of a is not referenced. If uplo = 'L' , the leading n -by- n lower triangular part of a contains the lower triangular part of the matrix A , and the strictly upper triangular part of a is not referenced.

lda

The leading dimension of the array a .

lda ≥ max( n ,1).

work: REAL for slansy and clansy . DOUBLE PRECISION for dlansy and zlansy . Workspace array, DIMENSION (max(1,lwork)) , where lwork≥n when norm = 'I' or ‘1’ or ‘O’ ; otherwise, work is not referenced.

Output Parameters

val: REAL for slansy / clansy DOUBLE PRECISION for dlansy / zlansy Value returned by the function.

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

Developer Reference for Intel® oneAPI Math Kernel Library for C

?lansy

Syntax

Include Files

Description

Input Parameters

Output Parameters