Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
5.5.1 - English

Change language to:
Français - 日本語 - Português - Русский

Please note that the recommended version of Scilab is 2024.1.0. This page might be outdated.
See the recommended documentation of this function

Scilab Help >> Files : Input/Output functions > listfiles


list of files

Calling Sequence

files = listfiles(paths [, flag, flagexpand])



a string matrix giving a set of pathnames (eventually ended by a pattern built with *).

flag, flagexpand

boolean optional parameters (default value is %t).


a string matrix.


listfiles can be used to list the files which match the patterns given by one of the paths entries. Patterns are given to the Unix ls or to the Windows dir commands in order to get information about 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/core/macros/*.sci is a valid pattern for both Unix and Windows.

If flag is true the pathnames given by paths are converted according to the getos() == 'Windows' value (see also pathconvert). Moreover, if flagexpand is true leading strings like SCIHOME, SCI or ~ are expanded using environment variables.

If the input argument paths is the name of a directory, the returned files are the names relative to that directory.

If the input argument paths contains more than one element, or if it contains a pattern (e.g. "/*", "*.c"), the returned files are the absolute paths (i.e. file name prepended with the name of the directory).




5.4.0 If paths is not a single string, all returned files are homogenized with the absolute path form.

See Also

  • findfiles — finding all files with a given file specification
  • basename — strip directory and suffix from filenames
  • pathconvert — converts a path to an OS path format.
Report an issue
<< isfile Files : Input/Output functions listvarinfile >>

Copyright (c) 2022-2024 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Thu Oct 02 13:46:51 CEST 2014