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.