next up previous contents
Next: COPY_SCATTER(ARRAYBASE,INDX1, ..., INDXn, MASK) Up: Specifications of Library Procedures Previous: COPY_PREFIX(ARRAYDIM, SEGMENT)

COPY_PREFIX(ARRAY, DIM, SEGMENT)

Optional Arguments. DIM, SEGMENT

Description. Computes a segmented copy scan along dimension DIM of ARRAY.

Class. Transformational function.

Arguments.

ARRAY may be of any type. It must not be scalar.

DIM (optional) must be scalar and of type integer with a value in the range , where is the rank of ARRAY.

SEGMENT (optional) must be of type logical and must have the same shape as ARRAY.

Result Type, Type Parameter, and Shape. Same as ARRAY.

Result Value. Element of the result has the value where is the set, in array element order, of elements of ARRAY selected to contribute to by the rules stated in Section 7.4.5. Note that this set is never empty.

Example. COPY_PREFIX( (/1,2,3,4,5/), SEGMENT= (/F,F,F,T,T/) ) is [1 1 1 4 4].