$file.ls

$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