36.4.1 Объекты FTP

Octave поддерживает протокол FTP через объектно-ориентированный интерфейс. Используйте функцию ftp для создания объекта FTP, представляющего подключение. Все функции FTP принимают объект FTP в качестве первого аргумента.

: f = ftp (host)

: f = ftp (host, username, password)

Подключиться к FTP-серверу host с именем пользователя username и паролем password.

Если username и password не указаны, используется пользователь "anonymous" без пароля. Возвращаемый объект FTP f представляет установленное FTP-соединение.

Список действий для объекта FTP показан ниже. Все функции требуют объект FTP в качестве первого аргумента.

Метод	Описание
ascii	Установить тип передачи в ascii
binary	Установить тип передачи в двоичный
cd	Изменить удалённый рабочий каталог
close	Закрыть FTP-соединение
delete	Удалить удалённый файл
dir	Вывести содержимое удалённого каталога
mget	Загрузить удалённые файлы
mkdir	Создать удалённый каталог
mput	Загрузить локальные файлы
rename	Переименовать или переместить удалённый файл или каталог
rmdir	Удалить удалённый каталог

: close (f)

Закрыть FTP-соединение, представленное объектом FTP f.

f — это объект FTP, возвращаемый функцией ftp.

: mget (f, file)

: mget (f, dir)

: mget (f, remote_name, target)

Загрузить удалённый файл file или каталог dir в локальный каталог по FTP-соединению f.

f — это объект FTP, возвращаемый функцией ftp.

Аргументы file и dir могут содержать подстановки, и любые файлы или каталоги на удалённом сервере, которые соответствуют шаблону, будут загружены.

Если задан третий строковый аргумент target, то он должен указывать путь к локальному каталогу назначения. target может быть относительным или абсолютным путём.

: mput (f, file)

Загрузить локальный файл file в текущий удалённый каталог по FTP-соединению f.

f — это объект FTP, возвращаемый функцией ftp.

Аргумент file передаётся через функцию glob, и любые файлы, соответствующие подстановкам в file, будут загружены.

: cd (f)

: cd (f, path)

Получить или установить удалённый каталог по FTP-соединению f.

f — это объект FTP, возвращаемый функцией ftp.

Если path не указан, вернуть текущий удалённый рабочий каталог. В противном случае установить удалённый каталог на path и вернуть новый удалённый рабочий каталог.

Если каталог не существует, выводится сообщение об ошибке, и рабочий каталог не изменяется.

: lst = dir (f)

Вывести текущий каталог в подробном виде для FTP-соединения f.

f — это объект FTP, возвращаемый функцией ftp.

: ascii (f)

Установить для FTP-соединения f использование ASCII-режима для передачи.

ASCII-режим подходит только для текстовых файлов, так как он преобразует представление новой строки на удалённом хосте в представление новой строки на локальном хосте.

f — это объект FTP, возвращаемый функцией ftp.

: binary (f)

Установить для FTP-соединения f использование двоичного режима для передачи.

В двоичном режиме нет преобразования символов новой строки из удалённого представления в локальное представление.

f — это объект FTP, возвращаемый функцией ftp.

: delete (f, file)

Удалить удалённый файл file по FTP-соединению f.

f — это объект FTP, возвращаемый функцией ftp.

: rename (f, oldname, newname)

Переименовать или переместить удалённый файл или каталог oldname в newname по FTP-соединению f.

f — это объект FTP, возвращаемый функцией ftp.

: mkdir (f, path)

Создать удалённый каталог path по FTP-соединению f.

f — это объект FTP, возвращаемый функцией ftp.

: rmdir (f, path)

Удалить удалённый каталог path по FTP-соединению f.

f — это объект FTP, возвращаемый функцией ftp.