Exponenta Banner
exponenta event banner

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

Примеры

свернуть все

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

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

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

Загрузите HTML для страницы на MATLAB Центральный Обмен файлами, который перечисляет представления, связанные с 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 Центральный Обмен файлами как в первом примере и задайте длительность тайм-аута 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 имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

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

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

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

Пример: '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

Документация MATLAB

Поддержка