vec_splati_ins

Purpose

Copies an immediate value into a specified word of each doubleword of a vector, leaving the remaining words unchanged.

Note: This built-in function is valid only when the -mcpu option is set to target Power10 processors.

Syntax

d=vec_splati_ins(a,b,c)

Result and argument types

The following table describes the types of the returned value and the function arguments.

Table 1. Result and argument types
d a b c
vector signed int vector signed int const unsigned int const signed int
vector unsigned int vector unsigned int const unsigned int const unsigned int
vector float vector float const unsigned int const float
Note: The value of b must be 0 or 1.

Result value

If b has a value of 0, then the even elements of d are set to the value of c and the odd element of d are copied from the corresponding element of a. Otherwise, b must have a value of 1, and the odd elements of d are set to the value of c and the even elements of d are copied from the corresponding elements of a.