OMFget_sub_iarray

Synopsis

       INTEGER FUNCTION OMFget_sub_iarray (object_id,
      . ndim,
      . dims,
      . min,
      . max,
      . iarray)
#include <avs/omf.inc>
       INTEGER object_id(OIDSIZ)
       INTEGER ndim
       INTEGER dims(ndims), min(ndims), max(ndims)
       INTEGER iarray(1)

Description

For a complete description of this function, see .

Arguments

object_id

The id of an object, expressed as an integer.

ndim

The number of dimensions in the array, expressed as an integer.

dims

An array of ndim integer values specifying the dimensions of the array.

min
max

Arrays of ndim integer values specifying the the minimum and maximum indices to retrieve in each dimension of the array.

iarray

The returned integer subarray.

Returned value

The status code (see ).

Example

#include <avs/omf.inc>
       INTEGER array_id(OIDSIZ)
       INTEGER ndims
       INTEGER dims(OM_ARRAY_MAXDIM)
       INTEGER min(OM_ARRAY_MAXDIM), max(OM_ARRAY_MAXDIM)
       INTEGER sub(2,3,5)
       ...
C
C get the dimensions of object array
       IF (OMFget_array_dims(array_id,
      . ndims,
      . dims) .NE. 1)
      . PRINT*,'Error getting array dimensions of object array'
C
C set the subarray indices
       min(1) = 0
       max(1) = 2
       min(2) = 1
       max(2) = 4
       min(3) = 5
       max(3) = 10
       ...
C get the subarray
       IF (OMFget_sub_iarray(array_id,
      . ndims,
      . dims,
      . min,
      . max,
      . sub) .NE. 1)
      . PRINT*,'Error getting subarray of object array'