Глобальный контекст.НайтиФайлы (Global context.FindFiles)

Глобальный контекст (Global context)

НайтиФайлы (FindFiles)

Синтаксис:

НайтиФайлы(<Путь>, <Маска>, <ИскатьВПодкаталогах>)

Параметры:

<Путь> (обязательный)

Тип: Строка.
Путь к каталогу, в котором производится поиск. Каталог может быть как на локальной сети, так и на 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.3.13.1809