$file.ls
Returns a directory listing
Usage
<array> $file.ls(<directory:string>,[<flags:string>[,<namefilter:string>]])
Description
Returns the listing of the specified directory as an array.

The <directory> should be given as a UNIX style path and is adjusted according to the system that KVIrc is running on.

<flags> may be a combination of the following characters:
    d: list directories
    f: list files
    l: list symbolic links
    r: list readable files
    w: list writable files
    x: list executable files
    h: list hidden files
    s: list system files
    n: sort files by name
    t: sort files by file time
    b: sort files by file size
    z: put the directories first, then the files
    k: invert sort order
    i: case insensitive sort
If <flags> is empty, then a default of dfrwxhs is set. If none of the r,w,x flags are set then KVIrc sets all of them by default.

If <namefilter> is passed then it is interpreted as a wildcard string that must match the entries to be returned.
Examples
%dir[]=$file.ls(/,"d") foreach(%f,%dir[])echo %f %dir[]=$file.ls(/usr/include,"f","t*.h"); foreach(%f,%dir[])echo %f %dir[]=$file.ls($file.homedir,"dfr"); foreach(%f,%dir[])echo %f

Index, Functions