Developer Reference for Intel® oneAPI Math Kernel Library - C

Developer Reference

  • 2021.1
  • 12/04/2020
  • Public Content
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.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.