From the NannyMUD documentation

LAST CHANGE

2001-02-15

FUNCTION

NAME
        get_player_objects - That, with extras.


SYNTAX
	varargs mapping get_player_objects(string pattern,
				           int flags,
					   int min_level,
					   int max_level)

LOCATION
	/obj/support

DESCRIPTION
	This function is used to get a set of player objects, based on glob
	patterns. Some filtering is also done.

	The argument 'pattern' is a string used by 'glob'. Players whose name
	matches this pattern are considered for inclusion in the result.

	The argument 'min_level' is the lowest level a player can have to be
	considered for inclusion. It defaults to zero.

	The argument 'max_level' is the highest level a player can have to be
	considered for inclusion. It defaults to the God's level.

	The 'flags' argument further influences what player objects are
	included. It is an integer, which is the result of logically 'or'ing
	together the following values:

	Value  Effect
	 1     Include invisible players. (*)
	 2     Include hard invisible admins. (*)
	 4     Don't use globs, but exakt match.(+)
	 8     Don't include mortals.
	 16    Don't include wizards.
	 32    Don't include admins.
	 64    Don't include paragons.
	 128   Don't include second characters.
	 256   Don't include test characters.

	 (*) Some further restrictions apply; only admin will get hardinvis
	 admins included, and you will only see invisible players of your
	 own level and lower.

	 (+) Exact match reduces this to a glorified find_player().

	 For example, a value of 385 (256|128|1) would exclude seconds and
	 test characters, and include invisble players.


RETURN VALUES
	The function returns a mapping of the form

	([ player_object_1 : player_real_name_1,
	   player_object_2 : player_real_name_2,
	   ...
	   player_object_N : player_real_name_N ]).


EXAMPLE
	get_player_object("b")
	  Get all player objects whose name starts with "b".

	get_player_objects("a", 8|4, 10, 15)
	  Use exact match, and exclude mortals.


SEE ALSO
        glob in efun/special/glob