Функция FileFindNextFile

Описание функции

FileFindNextFile

Возвращает следующее имя файла, определяемое дескриптором поиска.

FileFindNextFile(search)

Параметры

Дескриптор поиска, возвращённый функцией FileFindFirstFile().

Возвращаемое значение

Успех:	Возвращает имя очередного файла / папки, @extended принимает значения:
	0 = файл
	1 = папка
Ошибка:	Устанавливает @error равным 1, если больше нет файлов / папок, соответствующих поиску.

Примечания

Механизм работы поиска следующий: созданный дескриптор поиска хранит в себе путь, маску, текущую позицию поиска. На основе этой информации FileFindNextFile() возвращает следующий файл, сохраняя в дескриптор поиска текущую позицию, от которой продолжится следующий поиск. Вы можете открыть несколько дескрипторов поиска и они не будут влиять друг на друга.

После окончания работы с функциями FileFind... необходимо вызвать FileClose() для освобождения ресурсов, выделенных дескриптору поиска.

Из-за использования базовой функции Windows API - FindFirstFile, происходит поиск длинных и коротких имён файлов. Если вы получаете непредвиденные результаты, то убедитесь, что это не короткое имя файла.

Функцию можно подключить через команду exect

См. также

FileClose, FileFindFirstFile

Примеры:
Как создать кнопку?

exect=$var_h=FileFindFirstFile('C:\Test\*.*')||_ViewValues('$var_h')||$var_sfile=FileFindNextFile($var_h)||_ViewValues('$var_sfile')||FileClose($var_h) ;; пример поиска 1-го имени файла/папки в каталоге Test