Name: destruct - destruct an object

Syntax:
	destruct(string ob)
	destruct(object ob)

Description:
	Completely destroy and remove object "ob". After the call to
	destruct(), global variables won't exist any longer, only local
	and arguments to the current function.

	If an object self-destructs, it will immediately terminate execution
	and return 0. There is one exception: If the destruct statement is
	followed by a 'return 1' immediately after, then this return statement
	will be executed.

	If someone carried the object that was destructed, his local weight
	will be updated, that means 'query_weight' is called in the destructed
	object and 'add_weight' in its former environment.

	This function is also used by the destruct wizard command.

Return value: none

Example:
	self_destroy() {
		destruct(this_object());
		return 1;
	}

See also: efun/clone_object, w/destruct