VgaGames 3 - VgaGames3-object man-pages

[.. upper level ..]

VG3_ofunc_objlist_find_obj()

Return from the list of VgaGames3-objects the number of object-instances
for an object-ID and maybe a pointer to the first one.
SYNTAX
int VG3_ofunc_objlist_find_obj(struct vg3_ofunc *ofstruct, const char *oid, struct vg3_ofunc_object **objpp)

FUNCTION PARAMETERS
ofstruct Common VgaGames3-object structure
oid Object-ID, (may be NULL to find all objects-instances)
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.

DESCRIPTION
Return how many object-instances of an object-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. If oid is NULL, the number of all object-instances is returned.

SEE ALSO
VG3_ofunc_objlist_insert() VG3_ofunc_objlist_remove() VG3_ofunc_objlist_isvalid() VG3_ofunc_objlist_find_subobj()