findfiles
Функция поиска файлов по фильтру.
Синтаксис
findfiles(name, attr, s_id);
Аргументы
| Имя | Тип данных | Описание |
|---|---|---|
| name | string |
Строка, содержащая фильтр поиска файла по имени |
| attr | integer |
Атрибуты для поиска файлов |
| s_id | integer |
Выходной параметр, идентификатор списка строк для имен найденных файлов |
Описание
findfiles(name, attr, s_id) – функция поиска файлов по фильтру, заданному в
строке name, с атрибутами attr. Имена найденных файлов
возвращаются в списке строк с идентификатором s_id.
Атрибуты файлов могут принимать значения:
0 - Файлы "только чтение". Такой атрибут устанавливается на файлы, которые не рекомендовано изменять, удалять. Такой атрибут имеют файлы, например, записанные на компакт-дисках.
1 - Скрытые файлы. При обычных установках браузера и командира эти файлы невидимы.
2 - Системные файлы.
3 - Файл метки диска. Такой элемент в своем имени имеет название диска (максимум 11 символов).
4 - Атрибут признака каталога.
5 - Обычный файл. По умолчанию устанавливается на заново создаваемых файлах.
6 - Если установить в качестве атрибута искомых элементов, то будет произведен поиск по всем вышесказанным атрибутам.
Результат
| Имя | Тип данных | Описание |
|---|---|---|
| Функция возвращает имена найденных файлов в список строк |
Пример
var
s: string = "";
sl = createstringlist; //Создаём список строк
findfiles("*.prt",0,sl);
//Ищем файлы по заданной маске, тип атрибутов файлов - обычные файлы
for(i=0, countstringlist(sl))
s = s + getstringlist(sl,i) + chr(13);
freeobject(sl); //Освобождаем список строк
В процессе выполнения примера при помощи функции createstringlist создается
пустой список строк. При помощи функции findfiles происходит поиск файлов по
фильтру и запись имен найденных файлов в список строк. Далее, из имен всех найденных файлов
формируется строка, содержащая текст с разделителем "перевод каретки". Перед завершением
примера список строк уничтожается при помощи функции freeobject.
Дополнительные материалы
Нет.