Ruby 2.1.0 リファレンスマニュアル > ライブラリ一覧 > uriライブラリ > URIモジュール
クラスの継承リスト: URI
URI を扱うためのモジュールです。
unescape(str) -> String[permalink][rdoc]decode(str) -> StringURI 文字列をデコードした文字列を返します。
このメソッドは obsolete です。
例:
require 'uri'
puts URI.unescape('http://images.google.co.jp/images?q=%A5%E2%A5%CA%A5%EA%A5%B6&ie=EUC-JP')
#=> "http://images.google.co.jp/images?q=モナリザ&ie=EUC-JP"
decode_www_form(str, enc=Encoding::UTF_8) -> [[String, String]][permalink][rdoc]文字列から URL-encoded form data をデコードします。
application/x-www-form-urlencoded 形式のデータをデコードし、 [key, value] という形の配列の配列を返します。
enc で指定したエンコーディングの文字列が URL エンコードされたものと みなし、エンコーディングを付加します。
「_charset_ hack」はサポートされていません。 これで指定されたエンコーディングと Ruby のエンコーディングとの 対応がはっきりしないからです。これに関しては http://www.w3.org/TR/html5/parsing.html#character-encodings-0 も見てください。
このメソッドは http://www.w3.org/TR/html5/forms.html#url-encoded-form-data にもとづいて実装されています。
ary = URI.decode_www_form("a=1&a=2&b=3")
p ary #=> [['a', '1'], ['a', '2'], ['b', '3']]
p ary.assoc('a').last #=> '1'
p ary.assoc('b').last #=> '3'
p ary.rassoc('a').last #=> '2'
p Hash[ary] # => {"a"=>"2", "b"=>"3"}
[SEE_ALSO] URI.decode_www_form_component, URI.encode_www_form
decode_www_form_component(str, enc=Encoding::UTF_8) -> String[permalink][rdoc]URL-encoded form data の文字列の各コンポーネント をデコードした文字列を返します。
通常は URI.decode_www_form を使うほうがよいでしょう。
"+" という文字は空白文字にデコードします。
enc で指定したエンコーディングの文字列が URL エンコードされたものと みなし、エンコーディングを付加します。
このメソッドは http://www.w3.org/TR/html5/forms.html#url-encoded-form-data にもとづいて実装されています。
[SEE_ALSO] URI.encode_www_form_component, URI.decode_www_form
escape(str, unsafe = URI::UNSAFE) -> String[permalink][rdoc]encode(str, unsafe = URI::UNSAFE) -> StringURI 文字列をエンコードした文字列を返します。
このメソッドは obsolete です。
代わりに ERB::Util.#url_encode, CGI.escape, URI.encode_www_form_component, WEBrick::HTTPUtils.#escape_form, WEBrick::HTTPUtils.#escape などの使用を検討してください。 詳細は [ruby-core:29293] からのスレッドを参照してください。
例:
require 'uri'
p URI.escape('http://images.google.co.jp/images?q=モナリザ&ie=EUC-JP')
#=> "http://images.google.co.jp/images?q=%A5%E2%A5%CA%A5%EA%A5%B6&ie=EUC-JP"
encode_www_form(enum) -> String[permalink][rdoc]enum から URL-encoded form data を生成します。
HTML5 で定義されている application/x-www-form-urlencoded 形式の 文字列を生成します。
enum には通常 [key, value] という形の配列の配列を渡します。 以下の例を見てください。
URI.encode_www_form([["a", "1"], ["b", "2"], ["c", "x yz"]]) # => "a=1&b=2&c=x+yz"
実際には、each のブロック呼び出しで [key, value] の形のデータを渡すものであれば 何でも渡すことができます(例えば Hash など)。
URI.encode_www_form({"a"=>"1", "b"=>"2", "c"=>"x yz"})
# => "a=1&b=2&c=x+yz"
このメソッドは引数のエンコーディングを変換しません。そのため 送るデータのエンコーディングを変換したい場合はあらかじめ 変換しておいてください(例えば ASCII incompatible なものを UTF-8 に変換する場合など)。 各要素のエンコーデイングがばらばらの場合もあらかじめエンコーディングを 揃えてからこのメソッドを使うべきです。
このメソッドはファイルを入力にすることはできません。 ファイルを送りたい場合は multipart/form-data をつかうべきで このメソッドを使うべきではありません。
このメソッドは内部的に URI.encode_www_form_component を使っています。
このメソッドは http://www.w3.org/TR/html5/forms.html#url-encoded-form-data にもとづいて実装されています。
[SEE_ALSO] URI.encode_www_form_component, URI.decode_www_form
encode_www_form_component(str) -> String[permalink][rdoc]文字列を URL-encoded form data の1コンポーネント としてエンコードした文字列を返します。
通常は URI.encode_www_form を使うほうがよいでしょう。
このメソッドでは *, -, ., 0-9, A-Z, _, a-z, は変換せず、 空白は + に変換し、その他は %XX に、変換します。
このメソッドは http://www.w3.org/TR/html5/forms.html#url-encoded-form-data にもとづいて実装されています。
[SEE_ALSO] URI.decode_www_form_component, URI.encode_www_form
extract(str) -> [String][permalink][rdoc]extract(str, schemes) -> [String]extract(str) {|uri_str| ... } -> nilextract(str, schemes) {|uri_str| ... } -> nil文字列 str に対してパターンマッチングを試み、 絶対URIにマッチした部分文字列からなる配列として返します。 抽出する URI がなければ空の配列を返します。
第2引数に文字列の配列 schemes が与えられた場合は そのスキームだけを検索します。
ブロックが与えられた場合は String#scan と同様で、 マッチした部分がみつかるたびに uri_str に その部分を代入してブロックを評価します。 このときは nil を返します。
例:
require 'uri'
str = "
http://www.ruby-lang.org/
http://www.ruby-lang.org/man-1.6/
"
p URI.extract(str, ["http"])
=> ["http://www.ruby-lang.org/", "http://www.ruby-lang.org/man-1.6/"]
join(uri_str, *path) -> object[permalink][rdoc]文字列 uri_str と path ... を URI として連結して得られる URI オブジェクトを返します。
[RFC2396] の Section 5.2 の 仕様に従って連結します。 以下と等価です
URI.parse(uri_str) + path + ...
例:
require 'uri'
p URI.join('http://www.ruby-lang.org/', '/ja/man-1.6/')
=> #<URI::HTTP:0x2010017a URL:http://www.ruby-lang.org/ja/man-1.6/>
parse(uri_str) -> object[permalink][rdoc]与えられた URI から該当する URI::Generic のサブクラスのインスタンスを生成して 返します。scheme が指定されていない場合は、URI::Generic オブジェクトを返します。
例:
require 'uri'
p uri = URI.parse("http://www.ruby-lang.org/")
# => #<URI::HTTP:0x201002a6 URL:http://www.ruby-lang.org/>
p uri.scheme # => "http"
p uri.host # => "www.ruby-lang.org"
p uri.port # => 80
p uri.path # => "/"
regexp -> Regexp[permalink][rdoc]regexp(schemes) -> RegexpURIにマッチする正規表現を返します。
schemes を与えた場合は、そのスキームの URI にのみマッチする 正規表現を返します。
いずれの場合も返り値の正規表現は不定数の正規表現グループ (括弧) を含みます。この括弧の数はバージョンによって変動 する可能性があるので、それに依存したコードを書くべきでは ありません。
また、有効なURIではない文字列(たとえば"http://") にも マッチするため、有効なURIかどうかは必要に応じて別途 検査してください。
例:
require 'uri' p URI.regexp =~ "http://www.ruby-lang.org/" #=> 0
split(url) -> [String | nil][permalink][rdoc]URI を要素に分割した文字列の配列を返します。
各要素の種類と順番は以下のとおりです。
例:
require 'uri'
p URI.split("http://www.ruby-lang.org/")
#=> ["http", nil, "www.ruby-lang.org", nil, nil, "/", nil, nil, nil]
UNSAFE -> Regexp[permalink][rdoc]URIとして指定できない文字にマッチする正規表現
/[^-_.!~*'()a-zA-Z\d;\/?:@&=+$,\[\]]/n
です。