Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
Date 11/07/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

zlat2c

Converts a double complex triangular matrix to a complex triangular matrix.

Syntax

call zlat2c( uplo, n, a, lda, sa, ldsa, info )

Include Files

  • mkl.fi

Description

This routine is declared in mkl_lapack.fi.

The routine converts a DOUBLE COMPLEX triangular matrix A to a COMPLEX triangular matrix SA. zlat2c checks that the real and complex parts of all the elements of A are between -RMAX and RMAX, where RMAX is the overflow for the single-precision arithmetic. If this condition is not met, the conversion is aborted and a flag is raised. The routine does no parameter checking.

Input Parameters

uplo

CHARACTER*1.

Specifies whether the matrix A is upper or lower triangular:

= 'U': A is upper triangular,

= 'L': A is lower triangular.

n

INTEGER. The number of rows and columns in the matrix A. n≥ 0.

a

DOUBLE COMPLEX.

Array, DIMENSION (lda, *).

On entry, the n-by-n triangular matrix A.

lda

INTEGER. The leading dimension of the array a. lda ≥ max(1,n).

ldsa

INTEGER. The leading dimension of the array sa. ldsa ≥ max(1,n).

Output Parameters

sa

COMPLEX.

Array, DIMENSION (ldsa, *).

Only the part of sa determined by uplo is referenced. On exit,

  • if info = 0, the n-by-n triangular matrix sa,

  • if info > 0, the content of the part of sa determined by uplo is unspecified.

info

INTEGER.

=0: successful exit,

> 0: the real or complex part of an element of the matrix A is greater than the single-precision overflow threshold; in this case, the content of the part of sa determined by uplo is unspecified on exit.