vec_xst_len

Purpose

Stores a given byte length of a vector to a given address.

Note: This built-in function is valid only when both of the following conditions are met:
  • The -mcpu option is set to target POWER9 processors or higher.
  • The compiler mode is 64-bit.

Syntax

void vec_xst_len(a, b, c)

Argument types

The following table describes the types of the function arguments.

Table 1. Types of function arguments
a b c
vector signed char signed char * size_t
vector unsigned char unsigned char * size_t
vector signed short signed short * size_t
vector unsigned short unsigned short * size_t
vector signed int signed int * size_t
vector unsigned int unsigned int * size_t
vector signed long long signed long long * size_t
vector unsigned long long unsigned long long * size_t
vector float float * size_t
vector double double * size_t

Result

No value is returned. The specified bytes of a are stored into an address. The number of bytes to be stored is specified by c and the address is specified by b.

The behavior is undefined if the value of c is outside of 0-255. The behavior is implementation defined if the value of c is not a multiple of the vector element size.