LS List Files Function
Section: Operating System Functions
Usage
Lists the files in a directory or directories. The general syntax for its use isls('dirname1','dirname2',...,'dirnameN')
but this can also be expressed as
ls 'dirname1' 'dirname2' ... 'dirnameN'
or
ls dirname1 dirname2 ... dirnameN
For compatibility with some environments, the function dir
can also be used instead of ls
. Generally speaking, dirname
is any string that would be accepted by the underlying OS as a valid directory name. For example, on most systems, '.'
refers to the current directory, and '..'
refers to the parent directory. Also, depending on the OS, it may be necessary to ``escape'' the directory seperators. In particular, if directories are seperated with the backwards-slash character '\\'
, then the path specification must use double-slashes '\\\\'
. Two points worth mentioning about the ls
function:
- To get file-name completion to work at this time, you must use one of the first two forms of the command.
- If you want to capture the output of the
ls
command, use thesystem
function instead.
Example
First, we use the simplest form of thels
command, in which the directory name argument is given unquoted.
--> ls m*.m
Next, we use the ``traditional'' form of the function call, using both the parenthesis and the quoted string.
--> ls('m*.m')
In the third version, we use only the quoted string argument without parenthesis.
--> ls 'm*.m'