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 から文字ベクトル str に HTML Web コンテンツをダウンロードします。urlread は、ハイパーリンクのターゲットやイメージを取得しません。

例

str = urlread(URL,Name,Value) は、1 つ以上の Name,Value のペアの引数によって指定された追加オプションを使用します。

例

[str,status] = urlread(___) は、前述の構文の任意の入力引数を使用して、エラー メッセージの表示を抑制します。演算が正常に完了した場合、status は 1 です。失敗した場合は、status は 0 になります。

例

すべて折りたたむ

urlread に関連した投稿を一覧表示する MATLAB® Central の File Exchange の HTML ページをダウンロードします。

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

urlread は、指定された URL から HTML コンテンツを読み取り、文字ベクトル str にダウンロードします。

urlread に関連した投稿を一覧表示する MATLAB Central の File Exchange の 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 メソッドを使用して Web フォームに送信するデータのパラメーター。'get' および名前と値の対のパラメーターから成る cell 配列から構成されるコンマ区切りのペアとして指定されます。サポートされるパラメーターは URL によって異なります。

'Get' には、? および & 文字で区切られた URL のデータが含まれます。

例: 'Get',{'term','urlread'}

POST メソッドを使用して Web フォームに送信するデータのパラメーター。'post' および名前と値の一対のパラメーターの cell 配列から構成されるコンマ区切りのペアとして指定されます。サポートされるパラメーターは 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 は、Web コンテンツを文字ベクトルに保存します。コンテンツをファイルに保存するには、urlwrite を使用します。

  • 関数 urlread と関数 urlwrite は、FTP サイトから内容をダウンロードできます。または、関数 ftp で FTP サーバーに接続してから、関数 mget でファイルをダウンロードすることもできます。

バージョン履歴

R2006a より前に導入

参考

| | | | | | | |

トピック