OMFget_str_array_val

Synopsis

INTEGER FUNCTION OMFget_str_array_val (object_id,
      . index,
      . cval,
      . maxlen)
#include <avs/omf.inc>
INTEGER object_id(OIDSIZ)
INTEGER index, maxlen
CHARACTER*(*) cval

Description

For a complete description of this function, see OMget_str_array_val .

Arguments

object_id

The id of an object, expressed as an integer.

index

The array index, expressed as an integer.

cval

A character string specifying the object's value. This call requires that you pass a locally defined character variable and doesn't allow for memory allocation.

maxlen

The maximum number of characters to get, expressed as an integer.

Returned value

The status code (see OMget_str_array_val ).

Examples

#include <avs/omf.inc>
          INTEGER strarr_id(OIDSIZ)
          CHARACTER*30 value
          ...
          IF (OMFget_str_array_val(strarr_id,
.                                        0,
.                                        value,
.                                        LEN(value)) .NE. 1)
. PRINT*,'Error getting string value of object strarr'

See Also

OMFset_str_array_val