?lacpy
?lacpy
Copies all or part of one two-dimensional array to another.
Syntax
lapack_int
LAPACKE_slacpy
(
int
matrix_layout
,
char
uplo
,
lapack_int
m
,
lapack_int
n
,
const
float
*
a
,
lapack_int
lda
,
float
*
b
,
lapack_int
ldb
);
lapack_int
LAPACKE_dlacpy
(
int
matrix_layout
,
char
uplo
,
lapack_int
m
,
lapack_int
n
,
const
double
*
a
,
lapack_int
lda
,
double
*
b
,
lapack_int
ldb
);
lapack_int
LAPACKE_clacpy
(
int
matrix_layout
,
char
uplo
,
lapack_int
m
,
lapack_int
n
,
const
lapack_complex_float
*
a
,
lapack_int
lda
,
lapack_complex_float
*
b
,
lapack_int
ldb
);
lapack_int
LAPACKE_zlacpy
(
int
matrix_layout
,
char
uplo
,
lapack_int
m
,
lapack_int
n
,
const
lapack_complex_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 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 matrixAto be copied toB.If, the upper triangular part ofuplo='U'A;if, the lower triangular part ofuplo='L'A.Otherwise, all of the matrixAis copied.
- m
- The number of rows in the matrixA().m≥0
- n
- The number of columns inA().n≥0
- a
- Array, size at leastmax(1,for column major andlda*n)max(1,for row major layout.lda*m)Acontains them-by-nmatrixA.If, only the upper triangle or trapezoid is accessed; ifuplo='U', only the lower triangle or trapezoid is accessed.uplo='L'
- lda
- The leading dimension ofa;lda≥max(1,m)for column major layout and max(1,.n) for row major layout
- ldb
- The leading dimension of the output arrayb;ldb≥max(1,m)for column major layout and max(1,.n) for row major layout
Output Parameters
- b
- Array, size at leastmax(1,for column major andldb*n)max(1,for row major layout. Arrayldb*m)acontains them-by-nmatrixB.On exit,in the locations specified byB=Auplo.
Return Values
This function returns a value
info
.If , the execution is successful.
info
= 0If , the
info
= -i
i
-th parameter had an illegal value.