Synopsis
       INTEGER FUNCTION OMFget_str_val(object_id,
      .                                cval,
      .                                maxlen)
#include <avs/omf.inc>
       INTEGER object_id(OIDSIZ)
       INTEGER maxlen
       CHARACTER*(*) cval
 
Description
For a complete description of this function, see .
Arguments
object_id
The id of an object, 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 ).
Example
#include <avs/omf.inc>
       INTEGER parent_object(OIDSIZ), cval_id(OIDSIZ)
       CHARACTER*30 value
       ...
       IF (OMFfind_subobj(parent_object,
      .                                                  OMstr_to_name('cval'),
      .                                                  OM_OBJ_RD,
      .                                                  cval_id) .NE. 1)
      .                 PRINT*,'Error searching for cval'
C
       IF (OMFget_str_val(cval_id,value,LEN(value)) .NE. 1)
      .                 PRINT*,'Error getting value of object cval'
See also
Related modules: