Class: Resolv::DNS::Name
- Inherits:
-
Object
- Object
- Resolv::DNS::Name
- Defined in:
- lib/resolv.rb
Overview
A representation of a DNS name.
Class Method Summary collapse
-
.create(arg) ⇒ Object
Creates a new DNS name from
arg
.
Instance Method Summary collapse
-
#==(other) ⇒ Object
(also: #eql?)
:nodoc:.
-
#[](i) ⇒ Object
:nodoc:.
-
#absolute? ⇒ Boolean
True if this name is absolute.
-
#hash ⇒ Object
:nodoc:.
-
#initialize(labels, absolute = true) ⇒ Name
constructor
:nodoc:.
-
#inspect ⇒ Object
:nodoc:.
-
#length ⇒ Object
:nodoc:.
-
#subdomain_of?(other) ⇒ Boolean
Returns true if
other
is a subdomain. -
#to_a ⇒ Object
:nodoc:.
-
#to_s ⇒ Object
returns the domain name as a string.
Constructor Details
#initialize(labels, absolute = true) ⇒ Name
:nodoc:
1221 1222 1223 1224 |
# File 'lib/resolv.rb', line 1221 def initialize(labels, absolute=true) # :nodoc: @labels = labels @absolute = absolute end |
Class Method Details
.create(arg) ⇒ Object
Creates a new DNS name from arg
. arg
can be:
- Name
-
returns
arg
. - String
-
Creates a new Name.
1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 |
# File 'lib/resolv.rb', line 1210 def self.create(arg) case arg when Name return arg when String return Name.new(Label.split(arg), /\.\z/ =~ arg ? true : false) else raise ArgumentError.new("cannot interpret as DNS name: #{arg.inspect}") end end |
Instance Method Details
#==(other) ⇒ Object Also known as: eql?
:nodoc:
1237 1238 1239 1240 1241 |
# File 'lib/resolv.rb', line 1237 def ==(other) # :nodoc: return false unless Name === other return false unless @absolute == other.absolute? return @labels == other.to_a end |
#[](i) ⇒ Object
:nodoc:
1279 1280 1281 |
# File 'lib/resolv.rb', line 1279 def [](i) # :nodoc: return @labels[i] end |
#absolute? ⇒ Boolean
True if this name is absolute.
1233 1234 1235 |
# File 'lib/resolv.rb', line 1233 def absolute? return @absolute end |
#hash ⇒ Object
:nodoc:
1267 1268 1269 |
# File 'lib/resolv.rb', line 1267 def hash # :nodoc: return @labels.hash ^ @absolute.hash end |
#inspect ⇒ Object
:nodoc:
1226 1227 1228 |
# File 'lib/resolv.rb', line 1226 def inspect # :nodoc: "#<#{self.class}: #{self}#{@absolute ? '.' : ''}>" end |
#length ⇒ Object
:nodoc:
1275 1276 1277 |
# File 'lib/resolv.rb', line 1275 def length # :nodoc: return @labels.length end |
#subdomain_of?(other) ⇒ Boolean
Returns true if other
is a subdomain.
Example:
domain = Resolv::DNS::Name.create("y.z")
p Resolv::DNS::Name.create("w.x.y.z").subdomain_of?(domain) #=> true
p Resolv::DNS::Name.create("x.y.z").subdomain_of?(domain) #=> true
p Resolv::DNS::Name.create("y.z").subdomain_of?(domain) #=> false
p Resolv::DNS::Name.create("z").subdomain_of?(domain) #=> false
p Resolv::DNS::Name.create("x.y.z.").subdomain_of?(domain) #=> false
p Resolv::DNS::Name.create("w.z").subdomain_of?(domain) #=> false
1259 1260 1261 1262 1263 1264 1265 |
# File 'lib/resolv.rb', line 1259 def subdomain_of?(other) raise ArgumentError, "not a domain name: #{other.inspect}" unless Name === other return false if @absolute != other.absolute? other_len = other.length return false if @labels.length <= other_len return @labels[-other_len, other_len] == other.to_a end |
#to_a ⇒ Object
:nodoc:
1271 1272 1273 |
# File 'lib/resolv.rb', line 1271 def to_a # :nodoc: return @labels end |
#to_s ⇒ Object
1294 1295 1296 |
# File 'lib/resolv.rb', line 1294 def to_s return @labels.join('.') end |