Функция LOCFILE( )

Ищет файл на диске и возвращает имя файла вместе с его путем.

Синтаксис:

LOCFILE(cFileName [, cFileExtensions] [, cDialogCaption] [, cCreatorType])

Параметры:
cFileName
Задает имя файла, который нужно найти. Если cFileName содержит только имя файла, функция LOCFILE( ) сначала будет искать в каталоге Visual FoxPro, используемом по умолчанию. Если там файла не окажется, начнется просмотр пути Visual FoxPro. Для задания пути Visual FoxPro пользуйтесь командой SET PATH.
Если cFileName вместе с именем файла содержит путь, будет просматриваться заданная область. Если там файл не будет найден, LOCFILE( ) перейдет к поиску в каталоге Visual FoxPro, используемом по умолчанию, а затем к поиску по пути Visual FoxPro.
Если файл найден, LOCFILE( ) возвращает его имя и путь.
cFileExtensions
Задает расширения имени для искомого файла. Если имя файла, заданное аргументом cFileName, не включает расширение, Visual FoxPro дополняет его расширениями из списка cFileExtensions и продолжает поиск файла.
Аргумент cFileExtensions также задает расширения имен файлов, которые будут отображаться в диалоговом окне Open в случае, когда заданный файл не удается найти. Список расширений имен файлов Visual FoxPro и соответствующих типов создающих их приложений см. в разделе Расширения имен файлов и типы файлов.
cFileExtensions можно задавать в разных видах:
Если cFileExtensions содержит одно расширение (например .PRG), отображаются только файлы с данным расширением имени.
cFileExtensions может содержать список расширений имен файлов, разделенных точкой с запятой. Например, если задать PRG;FXP, будут отображены все файлы с расширениями имен .PRG и .FXP.
Если у файлов одинаковые имена, но разные расширения (например CUSTOMER.PRG и CUSTOMER.FXP), будет отображен только тот из этих файлов, расширение имени которого стоит первым в списке cFileExtensions.
cFileExtensions может содержать список расширений имен файлов, разделенных вертикальными линиями (например, PRG|FXP). В этом случае отображаются все файлы с любым из данных расширений, даже если у них одинаковые имена.
Если в качестве cFileExtensions задана просто точка с запятой (;), отображаютс все файлы, не имеющие расширения имени.
Если cFileExtensions пустая строка, а аргумент cCreatorType опущен, отображаются все файлы текущего каталога.
cFileExtensions может также включать символы подстановки (* и ?). Будут отображены все файлы, расширения имен которых удовлетворяют данному критерию с учетом символов подстановки. Например, если в качестве cFileExtensions задать ?X?, отображаются все файлы с расширениями имен .FXP, .EXE и .TXT.
cDialogCaption
Задает текст, который вы намерены использовать в качестве приглашения для пользователя. Этот текст фигурирует в диалоговом окне Open.
cCreatorType
Допустимо только в FoxPro для Macintosh.
Отображает файлы, созданные приложением определенного типа. Если в качестве cFileExtensions задана пустая строка, отображаются только файлы, созданные приложениями типа cCreatorType. Если в список cFileExtensions включен шаблон имен, отображаются файлы, имена которых удовлетворяют этому шаблону при условии, что создавшие их приложения принадлежат типу cCreatorType.
Список расширений имен файлов Visual FoxPro и соответствующих типов создающих их приложений см. в разделе Расширения имен файлов и типы файлов.

Результат:
Символьный.

Комментарии:
Диалоговое окно Open отображается в том случае, когда файл не удалось найти в каталоге, используемом по умолчанию, в каталогах пути Visual FoxPro или в точно указанном месте. Диалоговое окно Open можно использовать для поиска файла. Когда в диалоговом окне Open выбирается файл, его имя возвращается вместе с путем к нему.
Если выйти из диалогового окна Open, нажав кнопку Cancel или клавишу Esc, или кнопку Close меню Control, Visual FoxPro сгенерирует сообщение об ошибке, а LOCFILE( ) не возвратит никакого значения.


Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Каев Артем.