?lacpy

Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

Download PDF

ID 766686

Date 10/15/2026

Version

Public

?lacpy

Copies all or part of one two-dimensional array to another.

Syntax

call slacpy(uplo, m, n, a, lda, b, ldb)
call dlacpy(uplo, m, n, a, lda, b, ldb)
call clacpy(uplo, m, n, a, lda, b, ldb)
call zlacpy(uplo, m, n, a, lda, b, ldb)

Include Files

mkl.fi

Description

The routine copies all or part of a two-dimensional matrix A to another matrix B .

Input Parameters

The data types are given for the Fortran interface.

uplo

CHARACTER*1 .

Specifies the part of the matrix A to be copied to B . If uplo = 'U' , the upper triangular part of A ; if uplo = 'L' , the lower triangular part of A . Otherwise, all of the matrix A is copied.

m: INTEGER. The number of rows in the matrix A. The value of m must be at least zero.

n

INTEGER . The number of columns in A ( n≥ 0 ).

a: REAL for slacpy DOUBLE PRECISION for dlacpy COMPLEX for clacpy DOUBLE COMPLEX for zlacpy . Array a(lda,*) , contains the m -by- n matrix A . The second dimension of a must be at least max(1,n) . Array, size at least max(1, lda*n) for column major and max(1, lda*m) for row major layout. A contains the m -by- n matrix A . If uplo = 'U' , only the upper triangle or trapezoid is accessed; if uplo = 'L' , only the lower triangle or trapezoid is accessed.
lda: INTEGER . The leading dimension of a ; lda ≥ max(1, m ) for column major layout and max(1, n ) for row major layout .

ldb

INTEGER . The leading dimension of the output array b ; ldb≥ max(1, m) .

Output Parameters

b: REAL for slacpy DOUBLE PRECISION for dlacpy COMPLEX for clacpy DOUBLE COMPLEX for zlacpy . Array b ( ldb ,*), contains the m -by- n matrix B . The second dimension of b must be at least max(1,n) . Array, size at least max(1, ldb*n) for column major and max(1, ldb*m) for row major layout. Array a contains the m -by- n matrix B . On exit, B = A in the locations specified by uplo .

Return Values

No return value.

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 Fortran

?lacpy

Syntax

Include Files

Description

Input Parameters

Output Parameters

Return Values