Main Content

urlread

将 URL 内容下载到字符向量(不推荐)

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

说明

示例

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

示例

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

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

示例

全部折叠

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

urlreadhttps://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);

输入参数

全部折叠

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

示例: '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 参数,则还必须包括 UsernamePassword 参数。

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

示例: 'Username','myName'

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

示例: 'Password','myPassword123'

输出参数

全部折叠

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

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

提示

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

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

版本历史记录

在 R2006a 之前推出