VG3_ofunc_objlist_find_subobj()

[added in version 1.4]

Return from the list of VgaGames3-objects the number of object-instances
for a sub-ID of an object-ID and maybe a pointer to the first one.

SYNTAX

int VG3_ofunc_objlist_find_subobj(struct vg3_ofunc *ofstruct, const char *oid, unsigned int subid, struct vg3_ofunc_object **objpp)

FUNCTION PARAMETERS

ofstruct	Common VgaGames3-object structure
oid	Object-ID
subid	Sub-ID for this object-ID
objpp	For returning the first found object-instance, or NULL

RETURN VALUE

Returns the number of object-instances of the object-ID included in the list of VgaGames3-objects, which have set the sub-ID subid.

DESCRIPTION

Return how many object-instances of an object-ID, which have set a specific sub-ID, are in the list of VgaGames3-objects. If objpp is not NULL it contains after the call a pointer to the first object-instance of these.