vec_stril

Purpose

Copies a null-terminated string of elements from the input vector to the output vector, replacing all elements that follow the first zero element with zeros.

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

Syntax

d=vec_stril(a)

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
vector unsigned char	vector unsigned char
vector signed char	vector signed char
vector unsigned short	vector unsigned short
vector signed short	vector signed short

Result value

Elements in a are copied, in natural element order, to corresponding elements of d until the first zero element of a is encountered, or until all elements have been copied. If a zero element is encountered, all remaining elements of d are set to zero.