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