?lacp2

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 10/15/2026

Version

Public

?lacp2

Copies all or part of a real two-dimensional array to a complex array.

Syntax

lapack_int LAPACKE_clacp2(int matrix_layout, char uplo, lapack_int m, lapack_int n,
                          const float *a, lapack_int lda, lapack_complex_float *b,
                          lapack_int ldb);

lapack_int LAPACKE_zlacp2(int matrix_layout, char uplo, lapack_int m, lapack_int n,
                          const double *a, lapack_int lda, lapack_complex_double *b,
                          lapack_int ldb);

Include Files

mkl.h

Description

The routine copies all or part of a real matrix A to another matrix B .

Input Parameters

matrix_layout: Specifies whether matrix storage layout is row major ( LAPACK_ROW_MAJOR ) or column major ( LAPACK_COL_MAJOR ).

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. The value of m must be at least zero.

n

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

a

REAL for clacp2 DOUBLE PRECISION for zlacp2

Array, size at least max (1,lda*n) for column major and max (1,lda*m) for row major , 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

The leading dimension of a ; lda≥ max(1, m) for column major and lda≥ max(1, n) for row major .

ldb

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

Output Parameters

b

COMPLEX for clacp2 DOUBLE COMPLEX for zlacp2 .

Array, size at least max(1, ldb * n ) for column major layout and max(1, ldb * m ) for row major layout, 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 < 0 , the i -th parameter had an illegal value.
If info = -1011 , memory allocation error occurred.

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

?lacp2

Syntax

Include Files

Description

Input Parameters

Output Parameters

Return Values