Main Content

urlread

将 URL 内容下载到字符向量（不推荐）

全页折叠

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

语法

str = urlread(URL)
str = urlread(URL,Name,Value)
[str,status] = urlread(___)

说明

str = urlread(URL) 将 HTML 网页内容从指定的 URL 下载到字符向量 str 中。urlread 不检索超链接目标和图像。

示例

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

示例

[str,status] = urlread(___) 支持上述语法中的任何输入参量，并禁止显示错误消息。当操作成功时，status 为 1。否则，status 为 0

示例

全部折叠

在 MATLAB® Central File Exchange 上下载列出与 urlread 相关的提交内容的网页 HTML。

fullURL = ['https://www.mathworks.com/matlabcentral/fileexchange' ...
	   '?term=urlread'];
str = urlread(fullURL);

urlread 从指定的 URL 中读取内容并将 HTML 内容下载到字符向量 str。

在 MATLAB Central File Exchange 上下载列出与 urlread 相关的提交内容的网页 HTML。

URL = 'https://www.mathworks.com/matlabcentral/fileexchange';
str = urlread(URL,'Get',{'term','urlread'});

urlread 从 https://www.mathworks.com/matlabcentral/fileexchange/?term=urlread 读取内容并将 HTML 内容下载到字符向量 str 中。

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

fullURL = ['https://www.mathworks.com/matlabcentral/fileexchange' ...
	   '?term=urlread'];
str = urlread(fullURL,'Timeout',5);

输入参数

全部折叠

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

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

名称-值参数

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

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

示例: 'Timeout',10,'Charset','UTF-8' 指定 urlread 应在 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'

输出参量

全部折叠

指定 URL 处文件的内容，以字符向量形式返回。例如，如果 URL 对应于 HTML 网页，则 str 包含 HTML 文件中的文本和标记。如果 URL 对应于二进制文件，则 str 不可读。

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

提示

  • urlread 将 Web 内容保存到一个字符向量。要将内容保存到文件，请使用 urlwrite。

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

版本历史记录

在 R2006a 之前推出

另请参阅

| | | | | | | |

主题