urlread

Загрузите контент URL к вектору символов (не рекомендуемый)

urlread не рекомендуется. Используйте webread или webwrite вместо этого.

Синтаксис

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

Примеры

свернуть все

Загрузите HTML для страницы на MATLAB® Central File Exchange, который перечисляет представления, связанные с urlread.

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

urlread читает из заданного URL и загружает содержимое HTML на вектор символов str.

Загрузите HTML для страницы на MATLAB® Central File Exchange, который перечисляет представления, связанные с urlread.

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'

Аргументы в виде пар имя-значение

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'Timeout',10,'Charset','UTF-8' указывает, что urlread должен испытать таймаут после 10 секунд, и кодировка символов файла является UTF-8.

Параметры данных, чтобы отправить к веб-форме с помощью метода GET, заданного как пара, разделенная запятой, состоящая из 'get' и массив ячеек парных названий параметра и значений. Поддерживаемые параметры зависят от URL.

'Get' включает данные в URL, разделенный символами & и ?.

Пример: 'Get',{'term','urlread'}

Параметры данных, чтобы отправить к веб-форме с помощью метода POST, заданного как пара, разделенная запятой, состоящая из '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 сохраняет веб-контент в вектор символов. Чтобы сохранить содержимое в файл, используйте urlwrite.

  • urlread и urlwrite могут загрузить контент от FTP-сайтов. Также используйте функцию ftp, чтобы соединиться с FTP-сервером и функцией mget, чтобы загрузить файл.

Представлено до R2006a

Для просмотра документации необходимо авторизоваться на сайте