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

Documentation Area

Document Path: /doc/efun/clone_object

Name: clone_object - create a new instance of an object

Syntax:
	object clone_object(string file)

Description:
	The clone_object efun creates a new instance of an existing blueprint.
	If the blueprint doesn't exist, it will be created, that is, loaded.

	The file must be an absolute path to the description file of the
	object, but doesn't have to begin with a leading slash ('/').

Return value:
	It returns the (unique) object pointer of the newly created object.

Examples:
	object monster;
	monster=clone_object("lib/human/harry");
	move_object(monster, this_object());

See also:
w/clone
efun/destruct
efun/move_object
efun/transfer
efun/file_name