Глобальный контекст.НайтиФайлы (Global context.FindFiles)
Глобальный контекст (Global context)
НайтиФайлы (FindFiles)
Доступен, начиная с версии 8.0.
Синтаксис:
НайтиФайлы(<Путь>, <Маска>, <ИскатьВПодкаталогах>)Параметры:
<Путь> (обязательный)
Путь к каталогу, в котором производится поиск. Каталог может быть как на локальной сети, так и на ftp-сервере. При использовании этой схемы в адресах необходимо указывать прямые слеши '/', а не обратные '\'.
Допускается указание полного имени файла (путь + имя).
<Маска> (необязательный)
Маска выбора файлов.
Если параметр задан, то первый параметр воспринимается системой как путь к каталогу, в котором требуется найти файлы, удовлетворяющие маске выбора.
Для операционной системы MS Windows:
В строке маски, помимо обычных символов, допускается использование символа "*" (звездочка), обозначающего любое число произвольных символов, и "?" (знак вопроса), обозначающего один произвольный символ.
Примеры строки:
| "отчет201?.docx", "*.pdf". |
Для операционных систем Linux, macOS, iOS и Android:
В строке маски допускается использование следующих последовательностей:
- любой символ, допустимый в имени файла. Сопоставление указанных символов производится:
- для Linux, macOS - с учетом регистра,
- для iOS и Android - без учета регистра;
- "*" (звездочка) - любая последовательность символов;
- "?" (знак вопроса) - любой символ;
- "[" - класс символов. После открывающей квадратной скобки указывается последовательность символов. Шаблон соответствует любому из указанных символов. Можно указывать диапазон, используя "-". Описание класса символов завершается "]". Для указания "-" в качестве символа класса нужно указать его первым или последним символом. Если после "[" указан знак "!", то класс описывает все символы, кроме указанных.
| "Все файлы|*.*|Документы|???.docx;*.[Rr][Tt][Ff];doc[0-9].txt". |
<ИскатьВПодкаталогах> (необязательный)
Истина - будет произведен обход вложенных в параметр <Путь> каталогов и поиск в них.
Параметр игнорируется, если не задан параметр <Маска>, т.к. предполагается, что ищется один файл.
Значение по умолчанию: Ложь.
Возвращаемое значение:
Тип: Массив.Массив из значений типа Файл, содержащий найденные файлы.
Описание:
Осуществляет поиск файлов и каталогов по заданной маске, расположенных в заданном каталоге.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Все искомые объекты должны находиться в одном каталоге.Для работы метода на веб-клиенте необходимо предварительно подключить расширение работы с файлами.
Пример:
| НайденныеФайлы = НайтиФайлы("C:\Temp", "*.cdx"); |
См. также:
Глобальный контекст, метод НачатьПоискФайловГлобальный контекст, метод НайтиФайлыАсинх
Использование в версии:
Доступен, начиная с версии 8.0.
Описание изменено в версии 8.3.18.