class Resolv::DNS::Name - Documentation for Ruby 3.2

# class Resolv::DNS::Name

A representation of a `DNS` name.

### Public Class Methods

create(arg) click to toggle source

Creates a new `DNS` name from `arg`. `arg` can be:

`Name`

  returns `arg`.

`String`

  Creates a new `Name`.

    # File lib/resolv.rb, line 1241
    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

### Public Instance Methods

absolute?() click to toggle source

True if this name is absolute.

    # File lib/resolv.rb, line 1272
    def absolute?
      return @absolute
    end

subdomain_of?(other) click to toggle source

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

    # File lib/resolv.rb, line 1298
    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_s() click to toggle source

returns the domain name as a string.

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

Example:

    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"

    # File lib/resolv.rb, line 1333
    def to_s
      return @labels.join('.')
    end