Developer Reference for Intel® oneAPI Math Kernel Library for C

ID 766684
Date 11/07/2023
Public

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

Document Table of Contents

v?Unpack

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

Syntax

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 );

vcUnpackI( n, a, y, incy );

vcUnpackV( n, a, y, iy );

vcUnpackM( n, a, y, my );

vzUnpackI( n, a, y, incy );

vzUnpackV( n, a, y, iy );

vzUnpackM( n, a, y, my );

Include Files

  • mkl.h

Input Parameters

Name

Type

Description

n

const MKL_INT

Specifies the number of elements to be calculated.

a

const float* for vsUnpackI, vsUnpackV, vsUnpackM

const double* for vdUnpackI, vdUnpackV, vdUnpackM

const MKL_Complex8* for vcUnpackI, vcUnpackV, vcUnpackM

const MKL_Complex16* for vzUnpackI, vzUnpackV, vzUnpackM

Specifies the pointer to an array of size at least n that contains the input vector a.

incy

const MKL_INT for vsUnpackI, vdUnpackI, vcUnpackI, vzUnpackI

Specifies the increment for the elements of y.

iy

const int* for vsUnpackV, vdUnpackV, vcUnpackV, vzUnpackV

Specifies the pointer to an array of size at least n that contains the index vector for the elements of a.

my

const int* for vsUnpackM, vdUnpackM, vcUnpackM, vzUnpackM

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

float* for vsUnpackI, vsUnpackV, vsUnpackM

double* for vdUnpackI, vdUnpackV, vdUnpackM

const MKL_Complex8* for vcUnpackI, vcUnpackV, vcUnpackM

const MKL_Complex16* for vzUnpackI, vzUnpackV, vzUnpackM

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

The array must be:

  • for v?UnpackI, at least (1 + (n-1)*incy)
  • for v?UnpackV, at least max( n,max(ia[j]) ),j=0,..., n-1,
  • for v?UnpackM, at least n.