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® Обмен файлами в хранилище, в котором перечислены отправки, связанные с 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

Поддержка