123456789_123456789_123456789_123456789_123456789_

Class: Resolv::IPv4

Do not use. This class is for internal use only.
Relationships & Source Files
Inherits: Object
Defined in: lib/resolv.rb

Overview

A DNS IPv4 address.

Constant Summary

Class Method Summary

Instance Attribute Summary

  • #address readonly

    The raw IPv4 address as a String.

Instance Method Summary

Constructor Details

.new(address) ⇒ IPv4

[ GitHub ] 

  


# File 'lib/resolv.rb', line 2963



def initialize(address) # :nodoc:
  unless address.kind_of?(String)
    raise ArgumentError, 'IPv4 address must be a string'
  end
  unless address.length == 4
    raise ArgumentError, "IPv4 address expects 4 bytes but #{address.length} bytes"
  end
  @address = address
end


  







Class Method Details



  

    .create(arg)  
  



  

    

Creates a new IPv4 address from arg which may be:


IPv4




returns arg.


String




arg must match the Regex constant




  



  [ GitHub ]


  

  


# File 'lib/resolv.rb', line 2945



def self.create(arg)
  case arg
  when IPv4
    return arg
  when Regex
    if (0..255) === (a = $1.to_i) &&
       (0..255) === (b = $2.to_i) &&
       (0..255) === (c = $3.to_i) &&
       (0..255) === (d = $4.to_i)
      return self.new([a, b, c, d].pack("CCCC"))
    else
      raise ArgumentError.new("IPv4 address with invalid value: " + arg)
    end
  else
    raise ArgumentError.new("cannot interpret as IPv4 address: #{arg.inspect}")
  end
end


  







Instance Attribute Details



  

    #address   (readonly)
  



  

    

The raw IPv4 address as a String.


  



  [ GitHub ]


  

  


# File 'lib/resolv.rb', line 2979



attr_reader :address


  







Instance Method Details



  

    #==(other)  
  

  [ GitHub ]


  

  


# File 'lib/resolv.rb', line 2997



def ==(other) # :nodoc:
  return @address == other.address
end


  








  

    #eql?(other)  ⇒ Boolean 
  



  

    
  





  


  [ GitHub ]


  

  


# File 'lib/resolv.rb', line 3001



def eql?(other) # :nodoc:
  return self == other
end


  








  

    #hash  
  

  [ GitHub ]


  

  


# File 'lib/resolv.rb', line 3005



def hash # :nodoc:
  return @address.hash
end


  








  

    #inspect  
  

  [ GitHub ]


  

  


# File 'lib/resolv.rb', line 2985



def inspect # :nodoc:
  return "#<#{self.class} #{self}>"
end


  








  

    #to_name  
  



  

    

Turns this IPv4 address into a DNS::Name.


  



  [ GitHub ]


  

  


# File 'lib/resolv.rb', line 2992



def to_name
  return DNS::Name.create(
    '%d.%d.%d.%d.in-addr.arpa.' % @address.unpack('CCCC').reverse)
end


  








  

    #to_s  
  

  [ GitHub ]


  

  


# File 'lib/resolv.rb', line 2981



def to_s # :nodoc:
  return sprintf("%d.%d.%d.%d", *@address.unpack("CCCC"))
end