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

Documentation Area

Document Path: /doc/lib/find_user

Simul efun: find_user - an alternative to find a player: an interactive

Synopsis:
	object find_user(string name)
		or
	object find_user(string name, mixed flag)

Description:
	The simulated efun find_user is an alternative way to find a
	player by his/her/its 'name' PLUS by his/her/its 'alt_name'
	(see also 'stat <your_name>' first line: "Alt_Name").

	It's NOT a substitution for the find_player efun as it behaves
	different. First currently 'alt_names' are not checked for
	uniqueness and not for one-to-one correspondence.
	Secondly if there is no second argument (or equal 0), find_user
	returns 0 if a player is disconnected, no matter if searching
	for 'name' or for 'alt_name'. This is to reduce the different
	behaviours for 'name' and 'alt_name'.
	If any second argument is given, also disconnected interactives
	are found by 'name' and 'alt_name' and returned.

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

Examples:
	object player1, player2;
	player1 = find_user("fooboo");
	player2 = find_user("fooboo", 1);

Note:
	Find_user is used by 'tell', 'talk', 'ping', 'goto', 'stat', 'at',
	'trans', 'force', 'snoop' and 'accept'.
	The lord commands 'join', 'dismiss', 'promote' and 'degrade' use
	find_player.

See also:
efun/find_player
efun/find_living
efun/find_object
helpdir/tell
helpdir/talk
helpdir/ping
w/goto
w/stat
w/at
w/trans
w/force
w/snoop
w/accept
w/lordcommands