Developer Reference for Intel® oneAPI Math Kernel Library for C
?lacp2
Copies all or part of a real two-dimensional array to a complex array.
Syntax
lapack_intLAPACKE_clacp2 ( intmatrix_layout , charuplo , lapack_intm , lapack_intn , constfloat*a , lapack_intlda , lapack_complex_float*b , lapack_intldb );
lapack_intLAPACKE_zlacp2 ( intmatrix_layout , charuplo , lapack_intm , lapack_intn , constdouble*a , lapack_intlda , lapack_complex_double*b , lapack_intldb );
Include Files
mkl.h
Description
clacp2 zlacp2
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 ( m≥ 0 ).
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.