Developer Reference for Intel® oneAPI Math Kernel Library for C

ID 766684
Date 3/22/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

?laswp

Performs a series of row interchanges on a general rectangular matrix.

Syntax

lapack_int LAPACKE_slaswp (int matrix_layout , lapack_int n , float * a , lapack_int lda , lapack_int k1 , lapack_int k2 , const lapack_int * ipiv , lapack_int incx );

lapack_int LAPACKE_dlaswp (int matrix_layout , lapack_int n , double * a , lapack_int lda , lapack_int k1 , lapack_int k2 , const lapack_int * ipiv , lapack_int incx );

lapack_int LAPACKE_claswp (int matrix_layout , lapack_int n , lapack_complex_float * a , lapack_int lda , lapack_int k1 , lapack_int k2 , const lapack_int * ipiv , lapack_int incx );

lapack_int LAPACKE_zlaswp (int matrix_layout , lapack_int n , lapack_complex_double * a , lapack_int lda , lapack_int k1 , lapack_int k2 , const lapack_int * ipiv , lapack_int incx );

Include Files

  • mkl.h

Description

The routine performs a series of row interchanges on the matrix A. One row interchange is initiated for each of rows k1 through k2 of A.

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.

matrix_layout

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

n

The number of columns of the matrix A.

a

Array, size max(1, lda*n) for column major and max(1, lda*mm) for row major layout. Here mm is not less than maximum of values ipiv[k1-1+j*|incx|], 0≤j<k2-k1.

Array a contains the m-by-n matrix A.

lda

The leading dimension of the array a.

k1

The first element of ipiv for which a row interchange will be done.

k2

The last element of ipiv for which a row interchange will be done.

ipiv

Array, size k1+(k2-k1)*|incx|).

The vector of pivot indices. Only the elements in positions k1 through k2 of ipiv are accessed.

ipiv(k) = l implies rows k and l are to be interchanged.

incx

The increment between successive values of ipiv. If ipiv is negative, the pivots are applied in reverse order.

Output Parameters

a

On exit, the permuted matrix.

Return Values

This function returns a value info.

If info = 0, the execution is successful.

If info = -i, the i-th parameter had an illegal value.

If info = -1011, memory allocation error occurred.