_mm_insert_epi64
Microsoft Specific
Emits the Streaming SIMD Extensions 4 (SSE4) instruction pinsrq. This instruction inserts a 64-bit integer into a 128-bit parameter.
__m128i _mm_insert_epi64(
__m128i a,
__int64 b,
const int ndx
);
Parameters
[in] a
A 128-bit parameter that contains two 64-bit integers.[in] b
An integer value.[in] ndx
A constant index value that specifies the location to insert.
Result value
The result is the same as the input parameter a, except for the value at index ndx. The value at the specified index is replaced with b. This can be expressed with the following equations:
r0 := (ndx == 0) ? b : a0
r1 := (ndx == 1) ? b : a1
Requirements
Intrinsic |
Architecture |
|---|---|
_mm_insert_epi64 |
x64 |
Header file <smmintrin.h>
Remarks
r0 and a0 are the lower 64 bits of return value r and parameter a. r1 and a1 are the higher 64 bits of return value r and parameter a.
Only the least significant bit of ndx is interpreted.
Before you use this intrinsic, software must ensure that the processor supports the instruction.
Example
#include <stdio.h>
#include <smmintrin.h>
int main ()
{
__m128i a;
__int64 b = 4294901750;
const int ndx = 0;
a.m128i_i64[0] = 500000;
a.m128i_i64[1] = 3200000;
__m128i res = _mm_insert_epi64(a, b, ndx);
printf_s("Original a:\t%8I64d\t%8I64d\n\n", a.m128i_i64[0], a.m128i_i64[1]);
printf_s("%I64d should be inserted into index %d.\n", b, ndx);
printf_s("Result res:\t%8I64d\t%8I64d\n", res.m128i_i64[0], res.m128i_i64[1]);
return 0;
}
Original a: 500000 3200000 4294901750 should be inserted into index 0. Result res: 4294901750 3200000