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

Documentation Area

Document Path: /doc/efun/find_living

Name: find_living - find a living object

Syntax:
	object find_living(string name)

	The find_living efun finds the first living object that has the id
	'name'. A living object is an object that has done enable_commands,
	that is per default all players and monsters.

	The object must have set a name with set_living_name. There is a
	special hash table that speeds up the search for living objects, so
	if you know that an object is living, use find_living rather than
	find_object. If you know that the object is a player, use find_player,
	which is even faster.

Return value:
	If the living is found, its object pointer is returned, else 0.

Examples:
	object guard;
	guard=find_living("guard");

See also:
efun/find_player
efun/find_object
efun/enable_commands
efun/set_living_name