ŚLIB returns a character matrix of the
names of all the files in a particular directory. Names are padded to the
right with blanks as necessary. It
takes a single argument, which can be either a library number (usually 0 to 9,
corresponding to the rows of the ŚMOUNT table), or a character string representing an operating-system path.
For example, under Windows you might have:
ŚLIB 1 run2.aws run3.aws README.txt ŚLIB 'C:\' temp My Music DELL I386 AdobeWeb.log PDOXUSRS.NET PAGEFILE.SYS NTDETECT.COM DRIVERS Documents and Settings Firefox temp.gif temp.bmp
The file names are returned in full, including any file extension.
See also ŚFLIB which returns the names of component files only in a directory.
In Client-Server implementations of APLX, the front-end which implements the user-interface (the "Client") runs on one machine, and the APLX interpreter itself (the "Server") can run on a different machine.
In such systems, you can specify whether the directory being searched is on the Client or the Server machine. You do this by preceding the path name with either an Up Arrow † to indicate that the directory is on the Client, or a Down Arrow ‡ to indicate that it is on the Server. (If you do not specify, the default is that the access takes place on the Client.) This is true either if you specify the full path name in the ŚLIB call, or via the ŚMOUNT table.