Intel® C++ Compiler 16.0 User and Reference Guide

_mm512_i32lo[ext]gather_pd/ _mm512_mask_i32lo[ext]gather_pd

Gather float64 vector with int32 indices. Corresponding instruction is VGATHERDPD. This intrinsic only applies to Intel® Many Integrated Core Architecture (Intel® MIC Architecture).

Syntax

Without Mask

extern __m512d __cdecl _mm512_i32loextgather_pd(_m512i index, void const* mv, _MM_UPCONV_PD_ENUM conv, int scale, int hint);

extern __m512d __cdecl _mm512_i32logather_pd(__m512i index, void const* mv, _MM_UPCONV_EPI64_ENUM conv, int scale, _MM_HINT_NONE);

With Mask

extern __m512d __cdecl _mm512_mask_i32loextgather_pd(_m512d v1_old, __mmask8 k1, __m512i index, void const* mv, _MM_UPCONV_PD_ENUM conv, int scale, int hint);

extern __m512d __cdecl _mm512_mask_i32logather_pd(_m512d v1_old, __mmask8 k1, __m512i index, void const* mv, _MM_UPCONV_PD_ENUM conv, int scale, _MM_HINT_NONE);

Parameters

v1_old

 Source vector that retains old values of the destination vector; the resulting vector gets corresponding elements from v1_old for zero mask bits

k1

 Writemask; only those elements of the source vectors with corresponding bit set to '1' in the k1 mask are computed and stored in the result; elements in the result vector corresponding to zero bit in k1 are copied from corresponding elements of vector v1_old

index

 int32 vector containing indices in memory mv. Only the lower eight elements are used as indices. The upper eight elements are not used.

mv

Pointer to base address in memory

conv

Type of upconversion, which can be one of the following:

  • _MM_UPCONV_PD_NONE - no conversion

scale

Scaling factor for calculating address of elements. Takes following values: 1, 2, 4, and 8. The address of the i-th element in memory is calculated as: mv + index[i] * scale

hint

Hint that indicates to the processor that the data is non-temporal. Takes the value 0 or 1, where:

  • _MM_HINT_NONE = 0
  • _MM_HINT_NT = 1 (Load is non-temporal)

Description

Up-converts a set of eight memory locations to which the base address mv points, and the lower eight elements of the int32 index vector index with scale scale, and gathers them into a float64 vector.

The resulting vector for the masked variant is populated by elements for which the corresponding bit in the writemask vector k1 is set. The remaining elements of the resulting vector for the masked variant is populated by corresponding elements from v1_old.

The non-masked variant of the intrinsic is equivalent to the masked variant with full mask (k1=0xffff).

Note

These intrinsics do not have broadcast support.

Returns

Returns the result of the up-convert load operation.

Parent topic: Gather and Scatter Intrinsics