concepts/
efun/
SYNOPSIS
	string *get_dir(string str, int mask)

DESCRIPTION
	This function takes a path as argument and returns an array of
	file names and attributes in that directory.

	The filename part of the path may contain '*' as wildcards:
	every '*' matches an arbitrary amount of characters (or just
	itself). Thus get_dir ("/path/*") would return an array of
	all files in directory "/path/", or just ({ "/path/*" })
	if this file happens to exist.

	The optional second argument mask can be used to get
	information about the specified files.

	0	get_dir returns an emtpy array (not very useful)
	1	put the file names into the returned array.
	2	put the file sizes into the returned array.
	4	put the file modification dates into the returned
		array.

	The values of mask can be added together.

EXAMPLES
	get_dir("/w"); returns ({ "w" }) (if /w exists)
	get_dir("/w/"); and get_dir("/w/."); also both return ({ "w" })
	get_dir("/"); and get_dir("/."); return contents of directory "/".
	get_dir(".") returns the base name of the current directory.
	
	get_dir("/path/*") would return an array of all files in
	directory "/path/", or just ({ "/path/*" }) if this file
	happens to exist.

	get_dir("/", 1) is equivalent to get_dir("/")
	get_dir("/", 2) returns an array with the sizes of the files
	in the root directory.
	get_dir("/", 7) returns an one-dimensional array that contains
	for each file in the root directory its name, its size and its
	modification date.

SEE ALSO
	cat(E), mkdir(E), rmdir(E), file_size(E)