VgaGames 3 - VgaGames3-object man-pages

[.. upper level ..]

VG3_ofunc_objlist_nextlist()

Iteration over the list of VgaGames3-objects: Return next object-instance from snapshot of the list.
SYNTAX
struct vg3_ofunc_object * VG3_ofunc_objlist_nextlist(struct vg3_ofunc_objsnap *osnap)

FUNCTION PARAMETERS
osnap Snapshot of the list of VgaGames3-objects

RETURN VALUE
Returns the next object-instance from the snapshot, or NULL on end.

DESCRIPTION
For iteration over the list of VgaGames3-objects: Return the next object-instance from snapshot of the list. If the end of the list has been reached, NULL is returned.

EXAMPLE

Listing of the actual list of VgaGames3-objects:
  struct vg3_ofunc *ofstruct;
  struct vg3_ofunc_object *objp;
  struct vg3_ofunc_objsnap *osnap;

  ofstruct = ofunc_new();

  osnap = VG3_ofunc_objlist_newlist(ofstruct, NULL);
  printf("List:");
  while ((objp = VG3_ofunc_objlist_nextlist(osnap)) != NULL) {
    printf(" - OID=%s, INSTANCE-ID=%u\n", objp->oid, objp->instanceid);
  }
  VG3_ofunc_objlist_freelist(osnap);

SEE ALSO
VG3_ofunc_objlist_newlist() VG3_ofunc_objlist_freelist()