| FileFindFirstFile |  |
Возвращает "дескриптор поиска", связанный с указанной строкой.
Параметры
| filename |
Путь и имя файла для поиска. (поддерживаются подстановочные символы * и ?)
|
Возвращаемое значение
| Успех: | Возвращает "дескриптор поиска" для дальнейшего использования в функции FileFindNextFile(). |
| Ошибка: | Возвращает -1, если произошла ошибка. Если каталог пуст, значение @error устанавливается равным 1. |
Примечания
Строка для поиска не учитывает регистр.
Подстановочные символы (wildcards) маски: * означает 0 или более символов, а ? обозначает 0 или 1 символ. Если ваша строка для поиска содержит только маски (или '*.*'), то смотрите возвращаемые значения в примере ниже!
Можно использовать только один подстановочный символ в имени файла и один в его расширении, например a*.b?.
?? эквивалентно * (не указано в документации Microsoft).
Если используется 3-символьное расширение в строке поиска, то любое расширение, начинающееся с этих символов подходит под эту строку. Например, под маску '*.log' подпадает также файл 'test.log_1' (не указано в документации Microsoft).
После окончания работы с функциями FileFind... необходимо закрыть дескриптор, возвращённый функцией FileFindFirstFile() с помощью FileClose() для освобождения ресурсов, выделенных дескриптору поиска.
Имена каталогов также возвращается в соответствии с маской (wildcards), если таковые имеются.
Функцию можно подключить через команду exect
См. также
FileClose, FileFindNextFile
exect=$var_h=FileFindFirstFile('C:\Test\*.*')||_ViewValues('$var_h')||$var_sfile=FileFindNextFile($var_h)||_ViewValues('$var_sfile')||FileClose($var_h) ;; пример поиска 1-го имени файла/папки в каталоге Test
© Аверин Андрей для Total Commander Image Averin-And@yandex.ru