?trttf
?trttf
Copies a triangular matrix from the standard full format (TR)
to the
rectangular full packed format (TF).
Syntax
lapack_int
LAPACKE_strttf
(
int
matrix_layout
,
char
transr
,
char
uplo
,
lapack_int
n
,
const
float
*
a
,
lapack_int
lda
,
float
*
arf
);
lapack_int
LAPACKE_dtrttf
(
int
matrix_layout
,
char
transr
,
char
uplo
,
lapack_int
n
,
const
double
*
a
,
lapack_int
lda
,
double
*
arf
);
lapack_int
LAPACKE_ctrttf
(
int
matrix_layout
,
char
transr
,
char
uplo
,
lapack_int
n
,
const
lapack_complex_float
*
a
,
lapack_int
lda
,
lapack_complex_float
*
arf
);
lapack_int
LAPACKE_ztrttf
(
int
matrix_layout
,
char
transr
,
char
uplo
,
lapack_int
n
,
const
lapack_complex_double
*
a
,
lapack_int
lda
,
lapack_complex_double
*
arf
);
Include Files
- mkl.h
Description
The routine copies a triangular matrix
A
from the standard full format
to the Rectangular Full Packed
(RFP)
format. For the description of the RFP format, see Matrix Storage Schemes.
Input Parameters
- matrix_layout
- Specifies whether matrix storage layout is row major (LAPACK_ROW_MAJOR) or column major (LAPACK_COL_MAJOR).
- transr
- = 'N':arfmust be in the Normal format,= 'T':arfmust be in the Transpose format (forstrttfanddtrttf),= 'C':arfmust be in the Conjugate-transpose format (forctrttfandztrttf).
- uplo
- Specifies whetherAis upper or lower triangular:= 'U': A is upper triangular,= 'L': A is lower triangular.
- n
- The order of the matrixA..n≥0
- a
- Array, sizemax(1,(.lda*n))On entry, the triangular matrixA. Ifuplo= 'U', the leadingn-by-nupper triangular part of the arrayacontains the upper triangular matrix, and the strictly lower triangular part ofais not referenced. Ifuplo= 'L', the leadingn-by-nlower triangular part of the arrayacontains the lower triangular matrix, and the strictly upper triangular part ofais not referenced.
- lda
- The leading dimension of the arraya.lda≥max(1,n).
Output Parameters
- arf
- On exit, the upper or lower triangular matrixArray, size at leastmax(1,n*(n+1)/2).Astored in the RFP format.
Return Values
This function returns a value
info
.If , the execution is successful.
info
= 0If , the
info
< 0i
-th parameter had an illegal value.If , memory allocation error occurred.
info
= -1011