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 OMget_name_str_val .

Arguments

object_idx

object_idThe 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 OMget_name_str_val ).

Examples

#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'

See Also

OMFset_name_str_val