НайтиФайлы

[1cwiki]

Раздел

Глобальный контекст

Подразделы

Процедуры и функции работы с файлами

Синтаксис:

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

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

Тип: Строка.
Путь к каталогу, в котором производится поиск. Каталог может быть как на локальной сети, так и на ftp-сервере. При использовании этой схемы в адресах необходимо указывать прямые слеши '/', а не обратные '\'.
Допускается указание полного имени файла (путь + имя).
<Маска> (необязательный)

Тип: Строка.
Маска выбора файлов.
Если параметр задан, то первый параметр воспринимается системой как путь к каталогу, в котором требуется найти файлы, удовлетворяющие маске выбора.
Для операционной системы MS Windows:
В строке маски, помимо обычных символов, допускается использование символа "*" (звездочка), обозначающего любое число произвольных символов, и "?" (знак вопроса), обозначающего один произвольный символ.
Для операционных систем Linux, MacOS:
В строке маски допускается использование следующих последовательностей:
любой символ, допустимый в имени файла. Сопоставление указанных символов производится с учетом регистра;
"*" (звездочка) - любая последовательность символов;
"?" (знак вопроса) - любой символ;
"[" - класс символов. После открывающей квадратной скобки указывается последовательность символов. Паттерн соответствует любому из указанных символов. Можно указывать диапазон, используя "-". Описание класса символов завершается "]". Для указания "-" в качестве символа класса нужно указать его первым или последним символом. Если после "[" указан знак "!", то класс описывает все символы, кроме указанных.
<ИскатьВПодкаталогах> (необязательный)

Тип: Булево.
Истина - будет произведен обход вложенных в параметр <Путь> каталогов и поиск в них.
Параметр игнорируется, если не задан параметр <Маска>, т.к. предполагается, что ищется один файл.
Значение по умолчанию: Ложь.
Возвращаемое значение:

Тип: Массив.
Массив из значений типа Файл, содержащий найденные файлы.
Описание:

Осуществляет поиск файлов и каталогов по заданной маске, расположенных в заданном каталоге.

Доступность:

Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение(клиент), мобильное приложение(сервер).
Примечание:

Все искомые объекты должны находиться в одном каталоге.
Для работы метода на веб-клиенте необходимо предварительно подключить расширение работы с файлами.
Пример:

Код Выделить Развернуть

НайденныеФайлы = НайтиФайлы("C:\Temp", "*.cdx");