# listfiles

список файлов

## Последовательность вызова

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

## Аргументы

paths

  матрица строк, указывающая набор имён путей (обычно оканчивающихся шаблоном, построенным с `*`).

flag, flagexpand

  логические необязательные параметры (значение по умолчанию равно `%t`).

files

  матрица строк.

## Описание

Функция `listfiles` может быть использована для составления списка файлов, которые соответствуют шаблонам, указанным одним из элементов путей. Шаблоны указываются Unix-команде `ls` или Windows-команде `dir` для получения информации о файлах. Таким образом, чтобы написать переносимый Scilab-сценарий, следует указывать корректные знаки шаблонов для обеих ОС. Заметьте, что выполняется преобразование имени пути и, например, `SCI/core/macros/*.sci` является корректным шаблоном как для Unix, так и для Windows.

Если `flag` равен ИСТИНЕ, то имена пути, указанные с помощью `paths`, преобразуются в соответствии со значением `getos() == 'Windows'` (см. также pathconvert). Более того, если `flagexpand` равен ИСТИНЕ, то начальные строки, такие как `SCIHOME`, `SCI` или `~` расширяются с помощью переменных окружения.

Если входной путь является именем директории, то возвращаемые имена файлов `files` относятся к этой директории.

Если входные пути содержат шаблон (например `"/*"`, `"*.c"`), то к возвращаемым именам файлов `files` добавляется начало входного пути.

## Примеры

    files=listfiles(['SCI/modules/core/macros/*.sci';'SCI/modules/core/macros/*.bin']);

## История

5.4.0
Если пути не являются одиночной строкой, то все возвращаемые файлы представляются единообразно в форме абсолютного пути.

## Смотрите также

- findfiles
- basename
- pathconvert