?trttp

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 10/15/2026

Version

Public

?trttp

Copies a triangular matrix from the standard full format (TR) to the standard packed format (TP) .

Syntax

lapack_int LAPACKE_strttp(int matrix_layout, char uplo, lapack_int n, const float *a,
                          lapack_int lda, float *ap);

lapack_int LAPACKE_dtrttp(int matrix_layout, char uplo, lapack_int n, const double *a,
                          lapack_int lda, double *ap);

lapack_int LAPACKE_ctrttp(int matrix_layout, char uplo, lapack_int n,
                          const lapack_complex_float *a, lapack_int lda,
                          lapack_complex_float *ap);

lapack_int LAPACKE_ztrttp(int matrix_layout, char uplo, lapack_int n,
                          const lapack_complex_double *a, lapack_int lda,
                          lapack_complex_double *ap);

Include Files

mkl.h

Description

The routine copies a triangular matrix A from the standard full format to the standard packed format.

Input Parameters

uplo

Specifies whether A is upper or lower triangular: = ‘U’: A is upper triangular, = ‘L’: A is lower triangular.

n: Specifies the order of the matrix A . The value of n must be at least zero.

a

REAL for strttp , DOUBLE PRECISION for dtrttp , COMPLEX for ctrttp , DOUBLE COMPLEX for ztrttp .

Array, size max(1, lda * n ) .

On entry, the triangular matrix A . If uplo = ‘U’, the leading n -by- n upper triangular part of the array a contains the upper triangular matrix, and the strictly lower triangular part of a is not referenced. If uplo = ‘L’, the leading n -by- n lower triangular part of the array a contains the lower triangular matrix, and the strictly upper triangular part of a is not referenced.

lda

The leading dimension of the array a.lda ≥ max (1, n ).

Output Parameters

ap: REAL for strttp , DOUBLE PRECISION for dtrttp , COMPLEX for ctrttp , DOUBLE COMPLEX for ztrttp . Array, size at least max (1, n *( n +1)/2). On exit, the upper or lower triangular matrix A , packed columnwise in a linear array. The j -th column of A is stored in the array ap as follows: if uplo = ‘U’, ap(i + (j-1)*j/2) = A(i,j) for 1 ≤ i ≤ j , if uplo = ‘L’, ap(i + (j-1)*(2n-j)/2) = A(i,j) for j ≤ i ≤ n . On exit, the upper or lower triangular matrix A , packed columnwise in a linear array. (see Matrix Storage Schemes )

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

?trttp

Syntax

Include Files

Description

Input Parameters

Output Parameters

Return Values