ドキュメンテーション

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

urlread

URL の内容を文字ベクトルにダウンロード (非推奨)

urlread は推奨されません。代わりに webread または webwrite を使用してください。

構文

  • 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 になります。

すべて折りたたむ

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

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

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

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);

入力引数

すべて折りたたむ

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

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

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

POST メソッドを使用して Web フォームに送信するデータのパラメーター。'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 を含める場合は、引数 UsernamePassword も含めなければなりません。

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

例: 'Username','myName'

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

例: 'Password','myPassword123'

出力引数

すべて折りたたむ

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

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

詳細

すべて折りたたむ

ヒント

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

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

参考

| | | | |

R2006a より前に導入

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