Function `vec_xst_len`

#[target_feature(enable = "power9-vector")]
pub unsafe fn vec_xst_len<T>(v: T, a: <T as VectorXstores>::Out, l: usize)
where
    T: VectorXstores,

Vector Store with Length

Purpose

Stores a vector of a specified byte length.

Operation

Stores the number of bytes specified by c of the vector a to the address specified in b. The bytes are obtained starting from the lowest-numbered byte of the lowest-numbered element (as defined by the endianness of the target). All bytes of an element are accessed before proceeding to the next higher element.

Between 0 and 16 bytes, inclusive, will be stored. The length is specified by the least-significant byte of c, as min (c mod 256, 16). The behavior is undefined if the length argument is outside of the range 0–255, or if it is not a multiple of the vector element size.

Notes

vec_xst_len should not be used to store to cache-inhibited memory.