ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

urlread

URL コンテンツを MATLAB 文字列にダウンロード (POST データに必須)

urlread は Web コンテンツの読み取りには推奨されません。代わりに webread を使用してください。POST メソッドを使用してデータを送信するには urlread を使用します。

構文

  • 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(___) は、前出の構文の入力引数のいずれかを使用して、エラー メッセージの表示を抑制します。演算が正常に完了した場合、status1 です。失敗した場合は、status0 になります。

すべて折りたたむ

絶対 URL の指定による Web コンテンツのダウンロード

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

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

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

用語に関連する Web コンテンツのダウンロード

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

URL = 'http://www.mathworks.com/matlabcentral/fileexchange';
str = urlread(URL,'Get',{'term','urlread'});

urlread は、http://www.mathworks.com/matlabcentral/fileexchange/?term=urlread から HTML コンテンツを読み取り、文字列 str にダウンロードします。

タイムアウト期間の指定

最初の例について、MATLAB Central File Exchange 上のページからコンテンツをダウンロードし、タイムアウト期間を 5 秒間に指定します。

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

入力引数

すべて折りたたむ

URL — コンテンツの場所文字列

コンテンツの場所。文字列として指定されます。httpftpfile などの転送プロトコルを含みます。

例: 'http://www.mathworks.com/matlabcentral'

名前/値のペアの引数

オプションの Name,Value の引数ペアをコンマ区切りで指定します。Name は引数名で、Value は対応する値です。Name は単一引用符 (' ') で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を任意の順番で指定できます。

例: 'Timeout',10,'Charset','UTF-8' は、urlread が 10 秒後にタイムアウトし、ファイルの文字エンコードは UTF-8 であることを指定します。

'Get' — GET メソッドを使用して Web フォームに送信するデータセル配列

GET メソッドを使用して Web フォームに送信するデータのパラメーター。'get' および名前と値の対のパラメーターから成るセル配列から構成されるコンマ区切りのペアとして指定されます。サポートされるパラメーターは URL によって異なります。

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

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

'Post' — POST メソッドを使用して Web フォームに送信するデータセル配列

POST メソッドを使用して Web フォームに送信するデータのパラメーター。'post' および名前と値の一対のパラメーターのセル配列から構成されるコンマ区切りのペアとして指定されます。サポートされるパラメーターは URL によって異なります。

'Post' は、要求ヘッダーの一部としてデータを送信しますが、URL では明示的に行われません。

'Charset' — 文字エンコード文字列

文字エンコード。'Charset' と文字列から構成されるコンマ区切りのペアとして指定されます。Charset を指定しない場合、関数はファイルのヘッダーから文字エンコードを判別しようとします。文字エンコードを判別できない場合、Charset は既定としてファイル プロトコルに対してはネイティブのエンコードを、他のすべてのプロトコルについては UTF-8 を使用します。

例: 'Charset','ISO-8859-1'

'Timeout' — タイムアウト期間スカラー

タイムアウト期間 (秒)。'Timeout' とスカラーから構成されるコンマ区切りのペアとして指定されます。タイムアウト期間は、サーバーによる応答またはデータ送信の待機継続時間ではなく、関数エラーの時期を決定します。

例: 'Timeout',10

'UserAgent' — クライアントのユーザー エージェントの識別文字列

クライアントのユーザー エージェントの識別。'UserAgent' と文字列から構成されるコンマ区切りのペアとして指定されます。

例: 'UserAgent','MATLAB R2012b'

'Authentication' — HTTP 認証メカニズム'Basic'

コンマ区切りの 'Authentication' と文字列のペアとして指定する HTTP 認証メカニズム。現在は値 'Basic' のみがサポートされています。'Authentication','Basic' は基本認証を指定します。

引数 Authentication を含める場合は、引数 UsernamePassword も含めなければなりません。

'Username' — ユーザー識別子文字列

コンマ区切りの 'Username' と文字列のペアとして指定するユーザー識別子。引数 Username を含める場合は、引数 PasswordAuthentication も含めなければなりません。

例: 'Username','myName'

'Password' — ユーザー認証パスワード文字列

コンマ区切りの 'Password' と文字列のペアとして指定するユーザー認証パスワード。引数 Password を含める場合は、引数 UsernameAuthentication も含めなければなりません。

例: 'Password','myPassword123'

出力引数

すべて折りたたむ

str — 指定された URL にあるファイルのコンテンツ文字列

指定された URL にあるファイルのコンテンツ。文字列として返されます。たとえば、URL がページ HTML に対応している場合、str は HTMLファイルにテキストおよびマークアップを含めます。URL がバイナリ ファイルに対応している場合、str は読み取り不可です。

status — ダウンロードのステータス1 | 0

ダウンロードのステータス。1 または 0 のいずれかとして返されます。ダウンロードが正常に完了した場合、status1 です。失敗した場合は、status0 になります。

詳細

すべて折りたたむ

ヒント

  • urlread は、Web コンテンツを文字列に保存します。コンテンツをファイルに保存するには、urlwrite を使用します。

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

参考

| | |

この情報は役に立ちましたか?