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	Удалить удаленный каталог

См. также: @ftp/ascii, @ftp/binary, @ftp/cd, @ftp/close, @ftp/delete, @ftp/dir, @ftp/mget, @ftp/mkdir, @ftp/mput, @ftp/rename, @ftp/rmdir.

: close (f) ¶

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

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

См. также: @ftp/ftp.

: mget (f, file) ¶

: mget (f, dir) ¶

: mget (f, remote_name, target) ¶

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

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

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

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

См. также: @ftp/mput, @ftp/ftp.

: mput (f, file) ¶

: file_list = mput (f, file) ¶

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

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

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

Необязательный аргумент вывода file_list содержит массив ячеек строк с именами загруженных файлов.

См. также: @ftp/mget, @ftp/mkdir, @ftp/ftp.

: cwd = cd (f) ¶

: cd (f, path) ¶

: new_cwd = cd (f, path) ¶

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

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

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

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

См. также: @ftp/dir, @ftp/ftp.

: dir (f) ¶

: lst = dir (f) ¶

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

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

Если необязательный вывод lst запрошен, возвращается массив структур с одной записью на файл с полями name, date, bytes, isdir, datenum.

См. также: @ftp/cd, @ftp/mkdir, @ftp/rmdir, @ftp/ftp.

: ascii (f) ¶

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

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

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

См. также: @ftp/binary, @ftp/ftp.

: binary (f) ¶

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

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

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

См. также: @ftp/ascii, @ftp/ftp.

: delete (f, file) ¶

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

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

См. также: @ftp/rmdir, @ftp/rename, @ftp/ftp.

: rename (f, oldname, newname) ¶

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

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

См. также: @ftp/delete, @ftp/rmdir, @ftp/ftp.

: mkdir (f, path) ¶

Создать удаленную директорию path через FTP-соединение f.

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

См. также: @ftp/rmdir, @ftp/ftp.

: rmdir (f, path) ¶

Удалить удаленную директорию path через FTP-соединение f.

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

См. также: @ftp/delete, @ftp/mkdir, @ftp/rename, @ftp/ftp.