int aw_delete_all_objects (void)

DESCRIPTION

Deletes all of the objects in a world.

CALLBACK

AW_CALLBACK_DELETE_ALL_OBJECTS_RESULT

NOTES

This method is new in Active Worlds 3.1 and requires at least SDK build 18 and world server build 28. 

aw_delete_all_objects provide a simple mechanism for deleting all of the objects in a world.  Only instances owned by a caretaker (i.e. aw_int (AW_WORLD_CARETAKER_CAPABILITY) returns TRUE) may use this method.

For a complete description of cells and property in Active Worlds, see Property.

EXAMPLE

  int rc;

  /* delete all objects in the world */
  if (rc = aw_delete_all_objects ())
    printf ("Unable to delete all objects (reason %d)\n", rc);
  else
    printf ("All objects deleted.  I hope you made a backup!\n");

SEE ALSO

aw_object_add
aw_object_change
aw_object_delete
aw_object_load
aw_query