LPC Library Functions: destruct

NAME

destruct() - remove an object from the games

SYNOPSIS

void destruct( object ob );

DESCRIPTION

Completely destroy and remove object `ob'. After the call to destruct(), no object global variables will exist any longer - only function-specific locals and arguments. All pointers to the object in any variable or structure will immediately become zero. move_or_destruct() is called in all of the objects inside of the object being destructed.

If `ob' is this_object(), execution will continue, but it is good practice to return a value immediately.

SEE ALSO

clone_object(), new(), move(), move_or_destruct()