A
          / \      _             Play Now                         Nemesis on 
          | |     | |  _______   _        _   _______    _______   _    _______
          | |\    | | |   ____| |  \    /  | |   ____|  /   ____| | |  /   ____|
 /-------/-------------------------------------------------------------------,
O= Home <=XX|  About  News  Pics  Adventurers  Wizards  Download  Connect     >
 \-------\-------------------------------------------------------------------'
          | |   \   | |  |____  | |      | | |  |____   ___ \  \  | |  ___ \  \
          | |     \_| |_______| |_|      |_| |_______| |_______/  |_| |_______/
          \ /
           V  

Documentation Area

Document Path: /doc/efun/destruct

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