⎕LIB Return names of files in directory

⎕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.

Special considerations for Client-Server implementations of APLX

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.