/doc/efun/get_dir

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 '*' or '?' 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.

0x00 get_dir returns an emtpy array (not very useful)
0x01 put the file names into the returned array.
0x02 put the file sizes into the returned array.
0x04 put the file modification dates into the returned array.
0x20 if this mask bit is set, the result of get_dir() will _not_ be sorted.
The values of mask can be added together.

EXAMPLE

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.
transpose_array(({ get_dir(str, 0x21), get_dir(str, 2), get_dir(str, 4) }));
This returns an array of arrays, with filename, size and filetime as elements.

SEE ALSO

cat

mkdir

rmdir

file_size

| Home | Applied | Concepts | Efuns | Help | Intro | Lib | LPC | Prop | Obj | Sefuns | Std | W |