Ruby 2.3.0 リファレンスマニュアル > ライブラリ一覧 > resolvライブラリ > Resolvクラス

class Resolv

クラスの継承リスト: Resolv < Object < Kernel < BasicObject

要約

リゾルバを表すクラスです。 このクラス自体は実際には名前解決をせず、 Resolv.new で与えられたリゾルバに順に 問合せることしかしません。

このクラスのクラスメソッドで名前解決をした場合には、 内部で /etc/hosts, DNS の順に問合せます。

順に問合せる過程で、あるリゾルバが1個以上の 結果を返した場合、それ以降のリゾルバには 問い合わせをしません。

目次

特異メソッド
each_address each_name getaddress getaddresses getname getnames new
インスタンスメソッド
each_address each_name getaddress getaddresses getname getnames
定数
AddressRegex DefaultResolver

特異メソッド

each_address(name) {|address| ...} -> ()[permalink][rdoc]

ホスト名 name の IP アドレスをルックアップし、 各ルックアップ結果のアドレスに対してブロックを評価します。

ルックアップは /etc/hosts, DNS の順で行います。

[PARAM] name:
ホスト名を文字列で与えます。
each_name(address) {|name| ...} -> ()[permalink][rdoc]

IP アドレス address のホスト名をルックアップし、 各ルックアップ結果のホスト名に対してブロックを評価します。

ルックアップは /etc/hosts, DNS の順で行います。

[PARAM] address:
IPアドレスを文字列で与えます。
getaddress(name) -> String[permalink][rdoc]

ホスト名 name の IP アドレスをルックアップし、 ルックアップ結果の最初のアドレスを返します。

ルックアップは /etc/hosts, DNS の順で行います。 

require "resolv"
Resolv.getaddress("localhost") #=> "127.0.0.1"
Resolv.getaddress("www.ruby-lang.org") #=> "221.186.184.68"
[PARAM] name:
ホスト名を文字列で与えます。
[EXCEPTION] Resolv::ResolvError:
ルックアップに失敗したときに発生します。
getaddresses(name) -> [String][permalink][rdoc]

ホスト名 name の IP アドレスをルックアップし、 ルックアップ結果のアドレスリストを返します。

ルックアップは /etc/hosts, DNS の順で行います。 ルックアップに失敗した場合は空の配列が返されます。

[PARAM] name:
ホスト名を文字列で与えます。
getname(address) -> String[permalink][rdoc]

IP アドレス address のホスト名をルックアップし、 ルックアップ結果の最初のホスト名を文字列で返します。

ルックアップは /etc/hosts, DNS の順で行います。 

require "resolv"
Resolv.getname("221.186.184.68") #=> "carbon.ruby-lang.org"
[PARAM] address:
IPアドレスを文字列で与えます。
[EXCEPTION] Resolv::ResolvError:
ルックアップに失敗したときに発生します。
getnames(address) -> [String][permalink][rdoc]

IP アドレス address のホスト名をルックアップし、 ルックアップ結果のホスト名リストを返します。

ルックアップは /etc/hosts, DNS の順で行います。

[PARAM] address:
IPアドレスを文字列で与えます。
new(resolvers = [Hosts.new, DNS.new]) -> Resolv[permalink][rdoc]

resolvers に与えたリゾルバの配列を先頭から順に 名前解決を試すような、新しいリゾルバオブジェクトを返します。

resolvers の各要素は each_address と each_name という メソッドを持っていなければなりません。

[PARAM] resolvers:
リゾルバの配列

インスタンスメソッド

each_address(name) {|name| ...} -> ()[permalink][rdoc]

ホスト名 name の IP アドレスをルックアップし、 各ルックアップ結果のアドレスに対してブロックを評価します。

[PARAM] name:
ホスト名を文字列で与えます。
each_name(address) {|name| ...} -> ()[permalink][rdoc]

IP アドレス address のホスト名をルックアップし、 各ルックアップ結果のホスト名に対してブロックを評価します。

[PARAM] address:
IPアドレスを文字列で与えます。
getaddress(name) -> String[permalink][rdoc]

ホスト名 name の IP アドレスをルックアップし、 ルックアップ結果の最初のアドレスを返します。

[PARAM] name:
ホスト名を文字列で与えます。
[EXCEPTION] Resolv::ResolvError:
ルックアップに失敗したときに発生します。
getaddresses(name) -> [String][permalink][rdoc]

ホスト名 name の IP アドレスをルックアップし、 ルックアップ結果のアドレスリストを返します。

ルックアップに失敗した場合は空の配列が返されます。

[PARAM] name:
ホスト名を文字列で与えます。
getname(address) -> String[permalink][rdoc]

IP アドレス address のホスト名をルックアップし、 ルックアップ結果の最初のホスト名を文字列で返します。

[PARAM] address:
IPアドレスを文字列で与えます。
[EXCEPTION] Resolv::ResolvError:
ルックアップに失敗したときに発生します。
getnames(address) -> [String][permalink][rdoc]

IP アドレス address のホスト名をルックアップし、 ルックアップ結果のホスト名リストを返します。

[PARAM] address:
IPアドレスを文字列で与えます。

定数

AddressRegex -> Regexp[permalink][rdoc]

IPアドレスにマッチする正規表現です。

DefaultResolver -> Resolv[permalink][rdoc]

Resolv の各クラスメソッドを呼びだしたときに 利用されるリゾルバです。