vec_extracth

Purpose

Extracts an element from a pair of vectors using an index in reverse natural order.

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

Syntax

d=vec_extracth(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 unsigned long long vector unsigned char vector unsigned char unsigned int
vector unsigned long long vector unsigned short vector unsigned short unsigned int
vector unsigned long long vector unsigned int vector unsigned int unsigned int
vector unsigned long long vector unsigned long long vector unsigned long long unsigned int

Result value

Let v be a wide vector that consists of a concatenated with b. Let e be the element of v starting at byte position c in the reverse natural byte order. Then doubleword element 1 of d is set to e, and doubleword element 0 of d is set to zero.

Note: The byte index c must be in the range 0 to 31, inclusive. The result is undefined if the byte index does not address an element boundary.