---

36.4.1 FTP 对象¶

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

 

f = ftp (host) ¶

f = ftp (host, username, password) ¶

使用 username 和 password 连接到 FTP 服务器 host。

如果未指定 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 对象 f 所表示的 FTP 连接。

f 是由 ftp 函数返回的 FTP 对象。

另请参阅： @ftp/ftp.

 

mget (f, file) ¶

mget (f, dir) ¶

mget (f, remote_name, target) ¶

在 FTP 连接 f 上将远程文件 file 或目录 dir 下载到本地目录。

f 是由 ftp 函数返回的 FTP 对象。

参数 file 和 dir 可以包含通配符，远程服务器上匹配的任何文件或目录都将被下载。

如果指定了第三个字符串参数 target，则它必须指示本地目标目录的路径。target 可以是相对路径或绝对路径。

另请参阅： @ftp/mput, @ftp/ftp.

 

mput (f, file) ¶

file_list = mput (f, file) ¶

在 FTP 连接 f 上将本地文件 file 上传到当前远程目录中。

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) ¶

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

f 是由 ftp 函数返回的 FTP 对象。

另请参阅： @ftp/rmdir, @ftp/rename, @ftp/ftp.

 

rename (f, oldname, newname) ¶

通过 FTP 连接 f 将远程文件或目录 oldname 重命名或移动到 newname。

f 是由 ftp 函数返回的 FTP 对象。

另请参阅： @ftp/delete, @ftp/rmdir, @ftp/ftp.

 

mkdir (f, path) ¶

通过 FTP 连接 f 创建远程目录 path。

f 是由 ftp 函数返回的 FTP 对象。

另请参阅： @ftp/rmdir, @ftp/ftp.

 

rmdir (f, path) ¶

通过 FTP 连接 f 删除远程目录 path。

f 是由 ftp 函数返回的 FTP 对象。

另请参阅： @ftp/delete, @ftp/mkdir, @ftp/rename, @ftp/ftp.