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

Documentation Area

Document Path: /doc/efun/find_object

Name: find_object - find an object

Syntax:
	object find_object(string filename)

	The find_object efun finds the first object that has the file_name
	'name'. Cloned objects have a unique object number put after their
	filename for identification.

	If you know that an object is living or is a player, better use
	find_living or find_player, for these functions are much faster.

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

Examples:
	object post;
	post=find_object("room/post");

See also:
efun/find_player
efun/find_living
efun/file_name