Main Content

urlwrite

下载 URL 内容并保存到文件（不推荐）

全页折叠

不推荐使用 urlwrite。对于 http 或 https 协议，请改用 webread 或 webwrite。对于 ftp 协议，请使用 ftp 函数。对于 file 协议，请使用 fileread、fopen 或 copyfile。

语法

urlwrite(URL,filename)
urlwrite(URL,filename,Name,Value)
[filestr,status] = urlwrite(___)

说明

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

示例

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

示例

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

示例

全部折叠

在 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'});

urlwrite 从 https://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);

输入参数

全部折叠

内容位置，指定为字符向量。包括传输协议，例如 http、ftp 或 file。

示例: '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 参量，则还必须包括 Username 和 Password 参量。

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

示例: 'Username','myName'

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

示例: 'Password','myPassword123'

输出参量

全部折叠

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

下载状态，返回为 1 或 0。当下载成功时，status 为 1。否则，status 为 0。

提示

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

版本历史记录

在 R2006a 之前推出

另请参阅

| | | | | | |

主题