NAME
     COPY_PREFIX

SYNOPSIS
     USE HPF_LIBRARY

     COPY_PREFIX(ARRAY, DIM, SEGMENT)

DESCRIPTION
     COPY_PREFIX Computes a segmented copy scan  along  dimension
     DIM of ARRAY.

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

     DIM  this is an optional argument.  If present, it  must  be
          scalar  and of type integer with a value in the range 1
          <= DIM <= n, where n is the rank of ARRAY.

     SEGMENT
          this is an optional argument.  Must be of type  logical
          and have the same shape as MASK.

RESULT TYPE
     Same type and shape as ARRAY.

SEE ALSO
     COPY_SUFFIX.