vec_xl

Purpose

Loads a 16-byte vector from the memory address specified by the displacement a and the pointer b.

This built-in function is valid only when -qarch is set to target POWER7 processors or higher.

Syntax

d=vec_xl_be(a, b)

Result and argument types

The following tables describe the types of the function returned value and the function arguments in different bit modes.

Table 1. Data type of function returned value and arguments (in 32-bit mode)
d	a	b
vector signed char	int	signed char *
vector unsigned char		unsigned char *
vector signed short		signed short *
vector unsigned short		unsigned short *
vector signed int		signed int *
vector unsigned int		unsigned int *
vector signed long long		signed long long *
vector unsigned long long		unsigned long long *
vector float		float *
vector double		double *

Table 2. Data type of function returned value and arguments (in 64-bit mode)
d	a	b
vector signed char	long	signed char *
vector unsigned char		unsigned char *
vector signed short		signed short *
vector unsigned short		unsigned short *
vector signed int		signed int *
vector unsigned int		unsigned int *
vector signed long long		signed long long *
vector unsigned long long		unsigned long long *
vector float		float *
vector double		double *

Result value

vec_xl_be adds the displacement provided by a to the address provided by b to obtain the effective address for the load operation. It does not truncate the effective address to a multiple of 16 bytes.

The order of elements in the function result is big endian, even when the function is called on little endian systems.