OMFfind_subobj

OMFfind_subobj

Synopsis

INTEGER FUNCTION OMFfind_subobj (parent_id,
. name,
. mode,
. returned_id)
#include <avs/omf.inc>
INTEGER parent_id(OIDSIZ)
INTEGER name, mode
INTEGER returned_id(OIDSIZ)

Description

For a complete description of this function, see OMfind_subobj.
Arguments

parent_id
The id of an object, as an integer value.

name
The unqualified name of an object as an integer value.

mode
Indication of how the process intends to use the object. The following constants are predefined in the include file omf.inc :

Mode

Meaning

OM_OBJ_RD

The process intends to read the object, but not write to it (or any object that it might get using this id).

OM_OBJ_RW

The process intends to read and possibly write to the object.

returned_id
The id of the found object or OMnull_obj on failure.

Returned value

1 on success; 0 if OMnull_obj is returned.
Examples

C Find subobject x. Its parent's id is grp1_id.
#include <avs/omf.inc>
     INTEGER grp1_id (OIDSIZ), x_id(OIDSIZ)
     ...
     OMFlookup_subobj
     OMFfind_objIF (OMFfind_subobj(grp1_id,
.      OMFstr_to_name('x'),
. OM_OBJ_RD,
. x_id) .NE. 1) PRINT*,'Err searching for x'

See Also

OMFlookup_subobj

OMFfind_obj

Mode	Meaning
OM_OBJ_RD	The process intends to read the object, but not write to it (or any object that it might get using this id).
OM_OBJ_RW	The process intends to read and possibly write to the object.