NAME
     COPY_SUFFIX

SYNOPSIS
     USE HPF_LIBRARY

     COPY_SUFFIX(ARRAY, DIM, SEGMENT)

DESCRIPTION
     COPY_SUFFIX Computes a reverse  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 ARRAY.

RESULT TYPE
     Same type and shape as ARRAY.

SEE ALSO
     COPY_PREFIX.