OMFget_name_str

OMFget_name_str_val

Synopsis

       INTEGER FUNCTION OMFget_name_str_val(object_id,
      . name,
      . cval,
      . maxlen)

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

Description

For a complete description of this function, see .

Arguments

object_id

The id of an object, expressed as an integer.

name

The name of one of object_id's immediate subobjects, expressed as an integer.

maxlen

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

cval

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

Returned value

The status code (see ).

Example

#include <avs/omf.inc>
       INTEGER parent_object(OIDSIZ)
       CHARACTER*30 value
...
       IF (OMFget_name_str_val(parent_object,
      .    OMFstr_to_name('cval'),
      .    value
      .    LEN(value)) .NE. 1)
      . PRINT*,'Error getting value of object cval'