v?Unpack

Copies elements of a vector with unit increment to an array with specified indexing.

Syntax

Fortran:

call vsunpacki( n, a, y, incy )

call vsunpackv( n, a, y, iy )

call vsunpackm( n, a, y, my )

call vdunpacki( n, a, y, incy )

call vdunpackv( n, a, y, iy )

call vdunpackm( n, a, y, my )

vsUnpackI( n, a, y, incy );

vsUnpackV( n, a, y, iy );

vsUnpackM( n, a, y, my );

vdUnpackI( n, a, y, incy );

vdUnpackV( n, a, y, iy );

vdUnpackM( n, a, y, my );

Include Files

The FORTRAN 77 interfaces are specified in the mkl_vml.f77 include file, the Fortran 90 interfaces are specified in the mkl_vml.f90 include file, and the C interfaces are specified in the mkl_vml_functions.h include file.

Input Parameters

Name	Type	Description
n	FORTRAN 77: INTEGER Fortran 90: INTEGER, INTENT(IN) C: const int	Specifies the number of elements to be calculated.
a	FORTRAN 77: REAL for vsunpacki, vsunpackv, vsunpackm DOUBLE PRECISION for vdunpacki, vdunpackv, vdunpackm. Fortran 90: REAL, INTENT(IN) for vsunpacki, vsunpackv, vsunpackm DOUBLE PRECISION, INTENT(IN) for vdunpacki, vdunpackv, vdunpackm. C: const float* for vsUnpackI, vsUnpackV, vsUnpackM const double* for vdUnpackI, vdUnpackV, vdUnpackM	FORTRAN: Array, DIMENSION at least `n`. Specifies the input vector a. C: Specifies the pointer to an array of size at least `n` that contains the input vector a.
incy	FORTRAN 77: INTEGER for vsunpacki, vdunpacki. Fortran 90: INTEGER, INTENT(IN) for vsunpacki, vdunpacki. C: const int for vsUnpackI, vdUnpackI.	Specifies the increment for the elements of `y`.
iy	FORTRAN 77: INTEGER for vsunpackv, vdunpackv Fortran 90: INTEGER, INTENT(IN) for vsunpackv, vdunpackv C: const int* for vsUnpackV, vdUnpackV	FORTRAN: Array, DIMENSION at least `n`. Specifies the index vector for the elements of `y`. C: Specifies the pointer to an array of size at least `n` that contains the index vector for the elements of `a`.
my	FORTRAN 77: INTEGER for vsunpackm, vdunpackm Fortran 90: INTEGER, INTENT(IN) for vsunpackm, vdunpackm C: const int* for vsUnpackM, vdUnpackM	FORTRAN: Array, DIMENSION at least `n`, Specifies the mask vector for the elements of `y`. C: Specifies the pointer to an array of size at least `n` that contains the mask vector for the elements of `a`.

Output Parameters

Name	Type	Description
y	FORTRAN 77: REAL for vsunpacki, vsunpackv, vsunpackm DOUBLE PRECISION for vdunpacki, vdunpackv, vdunpackm Fortran 90: REAL, INTENT(OUT) for vsunpacki, vsunpackv, vsunpackm DOUBLE PRECISION, INTENT(OUT) for vdunpacki, vdunpackv, vdunpackm C: float* for vsUnpackI, vsUnpackV, vsUnpackM double* for vdUnpackI, vdUnpackV, vdUnpackM	FORTRAN: Array, DIMENSION for vsunpacki, at least `(1 + (n-1)incy)` for vsunpackv, at least `max( n,max(iy[j]) ),j=0,..., n-1` for vsunpackm/vdunpackm, at least `n` C: Specifies the pointer to an array that contains the output vector y. The array must be: for vsUnPackI, at least `(1 + (n-1)incy)` for vsUnPackV, at least `max( n,max(ia[j]) ),j=0,..., n-1`, for vsUnPackM, at least `n`.

Name

Type

Description

FORTRAN 77: REAL for vsunpacki, vsunpackv, vsunpackm

DOUBLE PRECISION for vdunpacki, vdunpackv, vdunpackm

Fortran 90: REAL, INTENT(OUT) for vsunpacki, vsunpackv, vsunpackm

DOUBLE PRECISION, INTENT(OUT) for vdunpacki, vdunpackv, vdunpackm

C: float* for vsUnpackI, vsUnpackV, vsUnpackM

double* for vdUnpackI, vdUnpackV, vdUnpackM

FORTRAN: Array, DIMENSION

for vsunpacki, at least (1 + (n-1)*incy)

for vsunpackv, at least max( n,max(iy[j]) ),j=0,..., n-1

for vsunpackm/vdunpackm, at least n

C: Specifies the pointer to an array that contains the output vector y.

The array must be:

for vsUnPackI, at least (1 + (n-1)*incy) for vsUnPackV, at least max( n,max(ia[j]) ),j=0,..., n-1, for vsUnPackM, at least n.