インテル® C++ コンパイラー 17.0 デベロッパー・ガイドおよびリファレンス

_mm512_i64[ext]scatter_epi64/ _mm512_mask_i64[ext]scatter_epi64

int64 インデックスを使用して、int64 ベクトルをメモリー位置へ分散 (Scatter) します。この組込み関数は、インテル® メニー・インテグレーテッド・コア (インテル® MIC) アーキテクチャーにのみ適用されます。

構文

マスクなし

void _mm512_i64extscatter_epi64(void* mv, __m512i index, __m512 v1, _MM_DOWNCONV_EPI64_ENUM conv, int scale, int hint);

void _mm512_i64scatter_epi64(void* mv, __m512i index, __m512 v1, int scale);

マスク付き

void _mm512_mask_i64extscatter_epi64(void* mv, __mmask8 k1, __m512i index, __m512 v1, _MM_DOWNCONV_EPI64_ENUM conv, int scale, int hint);

void _mm512_mask_i64scatter_epi64(void* mv, __mmask8 k1, __m512i index, __m512 v1, int scale);

引数

mv

メモリーのベースアドレスへのポインター

k1

書き込みマスク。k1 マスクの対応するビットが '1' にセットされているソースベクトルの要素のみ計算され、結果に格納されます。k1 の対応するビットが 0 にセットされている結果ベクトルの要素は、ベクトル v1_old の要素からコピーされます。

index

メモリー mv のインデックスを含む int64 ベクトル。

v1

ソースベクトル

conv

変換の種類。次のいずれかになります。

  • _MM_DOWNCONV_EPI64_NONE - 変換なし

scale

要素のアドレスを計算するスケールファクター。次の値を使用できます: 1、2、4、および 8。メモリーの i 番目の要素のアドレスは、次のように計算されます。mv + index[i] * scale

hint

プロセッサーにデータが非テンポラルでないことを示すヒント。0 または 1 を使用できます。それぞれの値の意味は次のとおりです。

  • _MM_HINT_NONE = 0
  • _MM_HINT_NT = 1 (ストアは非テンポラル)

説明

int64 ベクトル v1 の要素に対して、スケールファクター scale を使用して逆方向変換し、ベースアドレス mv とインデックス・ベクトル index により指定されるメモリー位置にストアします。

マスクなしの組込み関数は、フルマスク (k1=0xffff) のマスク付き組込み関数と同等です。

変換と hint ヒントが不要な場合は、関数名に ext が含まれない、単純化されたバージョンを使用できます。

戻り値

なし。