VEC_XL_LEN(ARG1, ARG2)

Purpose

Returns a vector that loads a given number of bytes from the given address.

This intrinsic procedure is valid only when -qarch is set to utilize the POWER9™ technology.

Class

Elemental function

Argument type and attributes

ARG1

An INTENT(IN) variable of any of the following types:

• INTEGER(1), INTEGER(2), INTEGER(4), or INTEGER(8)
• REAL(4), or REAL(8)
• VECTOR(INTEGER(1)), VECTOR(INTEGER(2)), VECTOR(INTEGER(4)), or VECTOR(INTEGER(8))
• VECTOR(UNSIGNED(1)), VECTOR(UNSIGNED(2)), VECTOR(UNSIGNED(4)), or VECTOR(UNSIGNED(8))
• VECTOR(REAL(4)), or VECTOR(REAL(8))

ARG2

An INTENT(IN) integer of kind 1, 2, 4 or 8

Result type and attributes

If ARG1 is a vector, the result is of the same type as ARG1; otherwise the result is a vector with elements of the same type as ARG1.

Result value

The result is loaded from the memory address that is specified by ARG1. The number of bytes loaded is specified by ARG2. Bytes of elements are initialized in order from the byte stream which is defined by the endianness of the operating environment. Any byte of elements that is not initialized is set to a 0 value.

The behavior is undefined if the value of ARG2 is outside of the range 0 - 255.