Name

dir — get file list

Calling Sequence

dir path
S=dir([path])

Parameters

path

a string matrix giving a directory pathname (eventually ended by a pattern built with *). Default value is .

S

a tlist of type dir with fields : name, date and isdir

Description

dir can be used to get the files which match the patterns given by the path argument. Patterns are given to the unix ls or to the windows dir commands in order to get information on files. Thus in order to write portable Scilab script valid wildcard patterns for both os are to be given. Note that Pathname conversion is performed and for example SCI/modules/core/macros/*.sci is a valid pattern for both unix and windows.

The name field of the returned variable is the column vector of the file names.

The date field of the returned variable is the column vector of integers containing a last modification date coded in second from 1 Jan 1970).

The isdir field of the returned variable is the column vector of boolean true if the corresponding name is a directory.

The default display of the returned structure is a column formatted list of files. It can be changed redefining the function %dir_p

Examples

 
dir
dir SCI/modules/core/macros/*.bin
x=dir('SCI/modules/core/macros/*.bin')
dt=getdate(x.date);
mprintf("%s: %04d-%02d-%02d %02d:%02d:%02d\n",x.name,dt(:,[1 2 6 7:9]))
 

See Also

listfiles , findfiles , ls , fileinfo , date