Class Resolv::DNS::Name
In: lib/resolv.rb
Parent: Object

Methods

==   []   absolute?   create   eql?   hash   inspect   length   new   subdomain_of?   to_a   to_s  

Public Class methods

create(arg)

[Source]

      # File lib/resolv.rb, line 1011
1011:       def self.create(arg)
1012:         case arg
1013:         when Name
1014:           return arg
1015:         when String
1016:           return Name.new(Label.split(arg), /\.\z/ =~ arg ? true : false)
1017:         else
1018:           raise ArgumentError.new("cannot interpret as DNS name: #{arg.inspect}")
1019:         end
1020:       end
new(labels, absolute=true)

[Source]

      # File lib/resolv.rb, line 1022
1022:       def initialize(labels, absolute=true)
1023:         @labels = labels
1024:         @absolute = absolute
1025:       end

Public Instance methods

==(other)

[Source]

      # File lib/resolv.rb, line 1035
1035:       def ==(other)
1036:         return false unless Name === other
1037:         return @labels == other.to_a && @absolute == other.absolute?
1038:       end
[](i)

[Source]

      # File lib/resolv.rb, line 1071
1071:       def [](i)
1072:         return @labels[i]
1073:       end
absolute?()

[Source]

      # File lib/resolv.rb, line 1031
1031:       def absolute?
1032:         return @absolute
1033:       end
eql?(other)

Alias for #==

hash()

[Source]

      # File lib/resolv.rb, line 1059
1059:       def hash
1060:         return @labels.hash ^ @absolute.hash
1061:       end
inspect()

[Source]

      # File lib/resolv.rb, line 1027
1027:       def inspect
1028:         "#<#{self.class}: #{self.to_s}#{@absolute ? '.' : ''}>"
1029:       end
length()

[Source]

      # File lib/resolv.rb, line 1067
1067:       def length
1068:         return @labels.length
1069:       end
subdomain_of?(other)

tests subdomain-of relation. 

  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

[Source]

      # File lib/resolv.rb, line 1051
1051:       def subdomain_of?(other)
1052:         raise ArgumentError, "not a domain name: #{other.inspect}" unless Name === other
1053:         return false if @absolute != other.absolute?
1054:         other_len = other.length
1055:         return false if @labels.length <= other_len
1056:         return @labels[-other_len, other_len] == other.to_a
1057:       end
to_a()

[Source]

      # File lib/resolv.rb, line 1063
1063:       def to_a
1064:         return @labels
1065:       end
to_s()

returns the domain name as a string.

The domain name doesn‘t have a trailing dot even if the name object is absolute. 

  p Resolv::DNS::Name.create("x.y.z.").to_s #=> "x.y.z"
  p Resolv::DNS::Name.create("x.y.z").to_s #=> "x.y.z"

[Source]

      # File lib/resolv.rb, line 1083
1083:       def to_s
1084:         return @labels.join('.')
1085:       end

[Validate]