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	Установить для передачи текстовый режим
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.