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:\n");
  while ((objp = VG3_ofunc_objlist_nextlist(osnap)) != NULL) {
    printf(" - OID=%s, INSTANCE-ID=%u\n", objp->oid, objp->instanceid);
  }
  VG3_ofunc_objlist_freelist(osnap);