Exponenta Banner
exponenta event banner

urlread

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

свернуть все на странице

urlread не рекомендуется. Для http или https протоколы, использование webread или webwrite вместо этого. Для ftp протоколы, использование ftp функции. Для file протоколы, использование fileread, fopen или copyfile.

Синтаксис

str = urlread (URL)
str = urlread (URL, имя, значение)
[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 является именем аргумента и 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

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

Поддержка