1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<TITLE>LS List Files Function
</TITLE>
</HEAD>
<BODY>
<H2>LS List Files Function
</H2>
<P>
Section: <A HREF=sec_os.html> Operating System Functions </A>
<H3>Usage</H3>
Lists the files in a directory or directories. The general syntax for its use is
<PRE>
ls('dirname1','dirname2',...,'dirnameN')
</PRE>
<P>
but this can also be expressed as
<PRE>
ls 'dirname1' 'dirname2' ... 'dirnameN'
</PRE>
<P>
or
<PRE>
ls dirname1 dirname2 ... dirnameN
</PRE>
<P>
For compatibility with some environments, the function <code>dir</code> can also be used instead of <code>ls</code>. Generally speaking, <code>dirname</code> is any string that would be accepted by the underlying OS as a valid directory name. For example, on most systems, <code>'.'</code> refers to the current directory, and <code>'..'</code> 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 <code>'\\'</code>, then the path specification must use double-slashes <code>'\\\\'</code>. Two points worth mentioning about the <code>ls</code> function:
<UL>
<LI> To get file-name completion to work at this time, you must use one of the first two forms of the command.
</LI>
<LI> If you want to capture the output of the <code>ls</code> command, use the <code>system</code> function instead.
</LI>
</UL>
<H3>Example</H3>
First, we use the simplest form of the <code>ls</code> command, in which the directory name argument is given unquoted.
<PRE>
--> ls m*.m
</PRE>
<P>
Next, we use the ``traditional'' form of the function call, using both the parenthesis and the quoted string.
<PRE>
--> ls('m*.m')
</PRE>
<P>
In the third version, we use only the quoted string argument without parenthesis.
<PRE>
--> ls 'm*.m'
</PRE>
<P>
</BODY>
</HTML>
|
