?lacpy

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 4/28/2026

Version

Public

?lacpy

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

Syntax

lapack_intLAPACKE_slacpy ( intmatrix_layout , charuplo , lapack_intm , lapack_intn , constfloat*a , lapack_intlda , float*b , lapack_intldb );

lapack_intLAPACKE_dlacpy ( intmatrix_layout , charuplo , lapack_intm , lapack_intn , constdouble*a , lapack_intlda , double*b , lapack_intldb );

lapack_intLAPACKE_clacpy ( intmatrix_layout , charuplo , lapack_intm , lapack_intn , constlapack_complex_float*a , lapack_intlda , lapack_complex_float*b , lapack_intldb );

lapack_intLAPACKE_zlacpy ( intmatrix_layout , charuplo , lapack_intm , lapack_intn , constlapack_complex_double*a , lapack_intlda , lapack_complex_double*b , lapack_intldb );

Include Files

mkl.h

Description

slacpy dlacpy clacpy zlacpy

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

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.

uplo

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

The number of rows in the matrix A ( m≥ 0 ).

n

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

The leading dimension of the output array b ; ldb≥ max(1, m) for column major layout and max(1, n ) for row major layout .

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

This function returns a value info .

If info = 0 , the execution is successful.
If info = -i , the i -th parameter had an illegal 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 C

?lacpy

Syntax

Include Files

Description

Input Parameters

Output Parameters

Return Values