vec_replace_unaligned

Purpose

Replaces some bytes of a vector with a given value, not necessarily aligned where an element of that size is normally placed.

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

Syntax

d=vec_replace_unaligned(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 signed int const int
vector unsigned int vector unsigned int unsigned int const int
vector signed long long vector signed long long signed long long const int
vector unsigned long long vector unsigned long long unsigned long long const int
vector float vector float float const int
vector double vector double double const int
Note: The value of c must be in the range 0 to 15, inclusive.

Result value

The result d is set to the value of a. Then the value of b is written to d starting at the byte position indicated by c in left-to-right byte order.