Main Content

urlwrite

下载 URL 内容并保存到文件(不推荐)

不推荐使用 urlwrite。对于 httphttps 协议,请改用 webreadwebwrite。对于 ftp 协议,请使用 ftp 函数。对于 file 协议,请使用 filereadfopencopyfile

说明

示例

urlwrite(URL,filename) 读取指定 URL 处的 Web 内容,并将内容保存到 filename 指定的文件。

示例

urlwrite(URL,filename,Name,Value) 使用一个或多个 Name,Value 对组参数指定的其他选项。

[filestr,status] = urlwrite(___) 支持上述语法中的任何输入参数,并将文件路径存储在变量 filestr 中,禁止显示错误消息。当操作成功时,status1。否则,status0

示例

全部折叠

在 MATLAB® Central File Exchange 上下载列出与 urlwrite 相关的提交内容的网页 HTML。将结果保存到当前文件夹中的 samples.html

fullURL = ['https://www.mathworks.com/matlabcentral/fileexchange' ...
           '?term=urlwrite'];
filename = 'samples.html';
urlwrite(fullURL,filename);

查看该文件。

web(filename)

在 MATLAB Central File Exchange 上下载列出与 urlwrite 相关的提交内容的网页 HTML。将结果保存到当前文件夹中的 samples.html

URL = 'https://www.mathworks.com/matlabcentral/fileexchange';
filename = 'samples.html';
urlwrite(URL,filename,'get',{'term','urlwrite'});

urlwritehttps://www.mathworks.com/matlabcentral/fileexchange/?term=urlwrite 下载 HTML 内容并将其写入 samples.html 中。

如第一个示例中所示在 MATLAB Central File Exchange 上下载网页的内容,并将超时持续时间指定为 5 秒。

fullURL = ['https://www.mathworks.com/matlabcentral/fileexchange' ...
	   '?term=urlwrite'];
filename = 'samples.html';
urlwrite(fullURL,filename,'Timeout',5);

输入参数

全部折叠

内容位置,指定为字符向量。包括传输协议,例如 httpftpfile

示例: 'https://www.mathworks.com/matlabcentral'

用于存储 Web 内容的文件的名称,指定为字符向量。如果未指定 filename 的路径,urlwrite 会将文件保存于当前文件夹中。

示例: 'myfile.html'

名称-值参数

将可选的参数对组指定为 Name1=Value1,...,NameN=ValueN,其中 Name 是参数名称,Value 是对应的值。名称-值参数必须出现在其他参数之后,但参数对组的顺序无关紧要。

在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name 引起来。

示例: 'Timeout',10,'Charset','UTF-8' 指定 urlwrite 应在 10 秒后超时,文件的字符编码为 UTF-8。

要使用 GET 方法发送到 Web 窗体的数据参数,指定为逗号分隔的对组,包含 'get' 以及由配对的参数名称和值组成的元胞数组。支持的参数取决于 URL。

'Get' 在 URL 中包括该数据,通过 ?& 字符进行分隔。

示例: 'Get',{'term','urlread'}

要使用 POST 方法发送到 Web 窗体的数据参数,指定为逗号分隔的对组,包含 'post' 以及由配对的参数名称和值组成的元胞数组。支持的参数取决于 URL。

'Post' 将数据作为请求标头的一部分提交,而不是在 URL 中显式提交。

字符编码,指定为逗号分隔的对组,包含 'Charset' 和一个字符向量。如果未指定 Charset,函数将尝试通过文件的标头确定字符编码。如果无法确定字符编码,Charset 默认为文件协议的本机编码,对于所有其他协议,编码为 UTF-8。

示例: 'Charset','ISO-8859-1'

超时持续时间(以秒为单位),指定为逗号分隔的对组,包含 'Timeout' 和一个标量。超时持续时间确定何时函数出错,而不是继续等待服务器响应或发送数据。

示例: 'Timeout',10

客户端用户代理标识,指定为逗号分隔的对组,包含 'UserAgent' 和一个字符向量。

示例: 'UserAgent','MATLAB R2012b'

HTTP 身份验证机制,指定为逗号分隔的对组,包含 'Authentication' 和一个字符向量。当前仅支持值 'Basic''Authentication','Basic' 指定基本身份验证。

如果包括 Authentication 参数,则还必须包括 UsernamePassword 参数。

用户标识符,指定为逗号分隔的对组,包含 'Username' 和一个字符向量。如果包括 Username 参数,则还必须包括 PasswordAuthentication 参数。

示例: 'Username','myName'

用户身份验证密码,指定为逗号分隔的对组,包含 'Password' 和一个字符向量。如果包括 Password 参数,则还必须包括 UsernameAuthentication 参数。

示例: 'Password','myPassword123'

输出参数

全部折叠

filename 指定的文件的路径,以字符向量形式返回。

下载状态,返回为 10。当下载成功时,status1。否则,status0

提示

  • urlreadurlwrite 可以从 FTP 站点下载内容。或者,使用 ftp 函数连接到 FTP 服务器,使用 mget 函数下载文件。

版本历史记录

在 R2006a 之前推出