Developer Reference for Intel® oneAPI Math Kernel Library - C

Developer Reference

  • 0.10
  • 10/21/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

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserverd for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804