---

36.4.1 FTP对象¶

Octave通过面向对象的接口支持FTP协议。使用该函数ftp以创建表示连接的FTP对象。所有FTP函数都将FTP对象作为第一个参数。

 

: f = ftp (host) ¶

: f = ftp (host, username, password) ¶

连接到FTP服务器主办具有用户名和暗语.

如果用户名和暗语未指定,用户匿名的不使用密码。返回的FTP对象f表示已建立的FTP连接。

FTP对象的操作列表如下所示。所有函数都需要一个FTP对象作为第一个参数。

方法	描述
ascii	将传输类型设置为ascii
二进制的	将传输类型设置为二进制
cd	更改远程工作目录
关	关闭FTP连接
删去	删除远程文件
目录	列出远程目录内容
mget	下载远程文件
mkdir	创建远程目录
mput	上载本地文件
重命名	重命名远程文件或目录
rmdir	删除远程目录

详见: @ftp/ascii, @ftp/二进制, @ftp/cd, @ftp/关闭, @ftp/删除, @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) ¶

下载远程文件文件或目录目录到FTP连接上的本地目录f.

f是从返回的FTP对象ftp作用

参数文件和目录可以包括通配符以及将下载的远程服务器上匹配的任何文件或目录。

如果第三个字符串参数目标则它必须指示到本地目标目录的路径。目标可以是相对路径,也可以是绝对路径。

详见: @ftp/mput, @ftp/ftp.

 

: mput (f, file) ¶

: file_list = mput (f, file) ¶

上传本地文件文件到FTP连接上的当前远程目录中f.

f是从返回的FTP对象ftp作用

参数文件通过地球仪函数和与中通配符匹配的任何文件文件将被上传。

可选输出参数文件列表包含一个包含已上载文件名称的字符串的元胞数组。

详见: @ftp/mget, @ftp/mkdir, @ftp/ftp.

 

: cwd = cd (f) ¶

: cd (f, path) ¶

: new_cwd = cd (f, path) ¶

获取或设置FTP连接上的远程目录f.

f是从返回的FTP对象ftp作用

如果路径未指定,返回远程当前工作目录。否则,将远程目录设置为路径并返回新的远程工作目录。

如果目录不存在,则会打印一条错误消息,并且不会更改工作目录。

详见: @ftp/dir, @ftp/ftp.

 

: dir (f) ¶

: lst = dir (f) ¶

以详细的形式列出FTP连接的当前目录f.

f是从返回的FTP对象ftp作用

如果可选输出lst被指定返回一个结构体数组,每个文件包含一个条目和字段Name, 日期,字节, isdir, 日期编号.

详见: @ftp/cd, @ftp/mkdir, @ftp/rmdir, @ftp/ftp.

 

: ascii (f) ¶

设置FTP连接f使用ASCII模式进行传输。

ASCII模式只适用于文本文件,因为它会将远程主机的换行表示转换为本地主机的换行表达。

f是从返回的FTP对象ftp作用

详见: @ftp/二进制, @ftp/ftp.

 

: binary (f) ¶

设置FTP连接f使用二进制模式进行传输。

在二进制模式中,换行符不会从远程表示转换为本地表示。

f是从返回的FTP对象ftp作用

详见: @ftp/ascii, @ftp/ftp.

 

: delete (f, file) ¶

删除远程文件文件通过FTP连接f.

f是从返回的FTP对象ftp作用

详见: @ftp/rmdir, @ftp/rename, @ftp/ftp.

 

: rename (f, oldname, newname) ¶

重命名或移动远程文件或目录旧名称到newname,通过FTP连接f.

f是从返回的FTP对象ftp作用

详见: @ftp/删除, @ftp/rmdir, @ftp/ftp.

 

: mkdir (f, path) ¶

创建远程目录路径,通过FTP连接f.

f是从返回的FTP对象ftp作用

详见: @ftp/rmdir, @ftp/ftp.

 

: rmdir (f, path) ¶

删除远程目录路径,通过FTP连接f.

f是从返回的FTP对象ftp作用

详见: @ftp/删除, @ftp/mkdir, @ftp/rename, @ftp/ftp.