Intel® C++ Compiler 16.0 User and Reference Guide

_mm512_i64[ext]gather_pd/ _mm512_mask_i64[ext]gather_pd

Gather float64 vector with int64 indices. This intrinsic only applies to Intel® Many Integrated Core Architecture (Intel® MIC Architecture).

Syntax

Without Mask

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

__m512d _mm512_i64gather_pd(__m512i index, void const* mv, int scale);

With Mask

__m512d _mm512_mask_i64extgather_pd(__m512d v1_old, __mmask8 k1, __m512i index, void const* mv, _MM_UPCONV_PD_ENUM conv, int scale, int hint);

__m512d _mm512_mask_i64gather_pd(__m512d v1_old, __mmask8 k1, __m512i index, void const* mv, int scale);

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

 int64 vector containing indices in memory mv.

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 int64 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).

Returns

Returns the result of the up-convert gather operation.

Parent topic: Gather and Scatter Intrinsics