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)은 지정한 URL에서 HTML 웹 콘텐츠를 문자형 벡터 str에 다운로드합니다. urlread는 하이퍼링크 대상과 이미지는 검색하지 않습니다.

예제

str = urlread(URL,Name,Value)는 하나 이상의 Name,Value 쌍 인수로 지정된 추가 옵션을 사용합니다.

예제

[str,status] = urlread(___)는 위에 열거된 구문에 나와 있는 입력 인수 중 하나를 사용하여 오류 메시지 표시를 차단합니다. 작업이 성공한 경우 status는 1입니다. 그렇지 않으면 status는 0이 됩니다.

예제

모두 축소

MATLAB® Central File Exchange에서 urlread와 관련된 제출 내용이 나열된 HTML 페이지를 다운로드합니다.

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

urlread는 지정한 URL에서 읽어 들이고 HTML 콘텐츠를 문자형 벡터 str에 다운로드합니다.

MATLAB Central File Exchange에서 urlread와 관련된 제출 내용이 나열된 HTML 페이지를 다운로드합니다.

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'

이름-값 인수

모두 축소

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: '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

클라이언트 사용자 에이전트 ID로, 'UserAgent'와 함께 문자형 벡터가 쉼표로 구분되어 지정됩니다.

예: 'UserAgent','MATLAB R2012b'

HTTP 인증 메커니즘으로, 'Authentication'과 함께 문자형 벡터가 쉼표로 구분되어 지정됩니다. 현재 'Basic' 값만 지원됩니다. 'Authentication','Basic'은 기본 인증을 지정합니다.

Authentication 인수를 포함시키는 경우 Username 인수와 Password 인수도 포함시켜야 합니다.

사용자 ID로, '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 이전에 개발됨

참고 항목

| | | | | | | |

도움말 항목