ExamineFTPDirectory()

Синтаксис

Result = ExamineFTPDirectory(#Ftp)

Описание

Создаёт перечисление записей текущего каталога (директории) FTP. Чтобы пошагово перебрать найденные записи, воспользуйтесь функцией NextFTPDirectoryEntry().

Параметры

#Ftp	Номер, идентифицирующий используемое FTP-Соединение.

Возвращаемое значение

Возвращает не нулевое значение, если операция прошла успешно, в противном случае - 0.

Комментарии

На данный момент поддерживается просмотр директорий только для Unix-совместимых серверов. Протокол FTP не определяет как именно должен выдаваться список элементов директории, поэтому каждый сервер выдаёт информацию о директории по-своему. К счастью большинство серверов в мире работают под управлением unix/linux и используют один и тот же способ выдачи данных. Однако гарантии того, что просмотр директории работает на любом сервере, нет. Эта команда будет дорабатываться по требованию чтобы автоматически обрабатывать разные типы серверов. Если сервер не поддерживается, пожалуйста воспользуйтесь функцией FTPDirectoryEntryRaw(), чтобы получить не-обработанную информацию о каждом элементе директории.

Подробную информацию о текущей записи перечисления FTP можно получить с помощью функции:

FTPDirectoryEntryType() - тип текущей записи (файл или каталог).
FTPDirectoryEntryName() - имя текущей записи.
FTPDirectoryEntrySize() - размер текущей записи (если это файл).
FTPDirectoryEntryDate() - дата последнего изменения текущей записи.
FTPDirectoryEntryAttributes() - атрибуты текущей записи.

Чтобы изменить текущий каталог FTP, используйте SetFTPDirectory().

Пример

InitNetwork()

If OpenFTP(0, "ftp.free.fr", "anonymous", "")
    If ExamineFTPDirectory(0)
        While NextFTPDirectoryEntry(0)
            Debug FTPDirectoryEntryName(0)
        Wend
        FinishFTPDirectory(0)
    EndIf
Else
    Debug "Не удается подключиться к ftp.free.fr"
EndIf

См. также

NextFTPDirectoryEntry(), FinishFTPDirectory()

Поддерживаемые OS

Все