exponenta event banner

urlwrite

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

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

Описание

пример

urlwrite(URL,filename) читает веб-содержимое в указанном URL и сохраняет его в файл, указанный в filename.

пример

urlwrite(URL,filename,Name,Value)использует дополнительные параметры, указанные одним или несколькими Name,Value аргументы пары.

[filestr,status] = urlwrite(___) сохраняет путь к файлу в переменной filestrи подавляет отображение сообщений об ошибках, используя любой из входных аргументов в предыдущих синтаксисах. При успешном выполнении операции status является 1. В противном случае status является 0.

Примеры

свернуть все

Загрузите HTML-код страницы на сервере MATLAB ® Central File Exchange со списком отправлений, связанных с urlwrite. Сохранить результаты в samples.html в текущей папке.

fullURL = ['https://www.mathworks.com/matlabcentral/fileexchange' ...
           '?term=urlwrite'];
filename = 'samples.html';
urlwrite(fullURL,filename);

Просмотрите файл.

web(filename)

Загрузите HTML-код страницы на сервере MATLAB Central File Exchange, в котором перечислены сообщения, связанные с urlwrite. Сохранить результаты в samples.html в текущей папке.

URL = 'https://www.mathworks.com/matlabcentral/fileexchange';
filename = 'samples.html';
urlwrite(URL,filename,'get',{'term','urlwrite'});

urlwrite загружает содержимое HTML из https://www.mathworks.com/matlabcentral/fileexchange/?term=urlwrite и записывает его в samples.html.

Загрузите содержимое со страницы на сервере MATLAB Central File Exchange, как в первом примере, и укажите длительность тайм-аута 5 секунд.

fullURL = ['https://www.mathworks.com/matlabcentral/fileexchange' ...
	   '?term=urlwrite'];
filename = 'samples.html';
urlwrite(fullURL,filename,'Timeout',5);

Входные аргументы

свернуть все

Расположение содержимого, указанное как символьный вектор. Включить протокол передачи, например, http, ftp, или file.

Пример: 'https://www.mathworks.com/matlabcentral'

Имя файла для хранения веб-содержимого, указанного как символьный вектор. Если не указан путь для filename, urlwrite сохраняет файл в текущей папке.

Пример: 'myfile.html'

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

Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

Пример: 'Timeout',10,'Charset','UTF-8' указывает, что urlwrite должно истекать через 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'

Выходные аргументы

свернуть все

Путь к файлу, указанному filename, возвращается в виде символьного вектора.

Состояние загрузки, возвращено как 1 или 0. При успешной загрузке status является 1. В противном случае status является 0.

Совет

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

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