OMFset_str_val, OMFget_str_val

Synopsis

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

INTEGER FUNCTION OMFget_str_val (object_id, cval, maximum_size)
#include <avs/omf.inc>
INTEGER object_id(OIDSIZ)
INTEGER maximum_size(OIDSIZ)
CHARACTER*(*) cval

Description

For a complete description of this function, see OMget_str_val and OMset_str_val in Appendix C of the Developer's Reference .

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.

Returned value

The status code. See Return Status

Examples

#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
value = 'My String'
IF (OMFset_str_val(cval_id,value) .NE. 1)
. PRINT*,'Error setting value of object cval'

See Also

none.