Class: Gem::Resolv::IPv4

Inherits:
Object
  • Object
show all
Defined in:
lib/rubygems/vendor/resolv/lib/resolv.rb

Overview

A Gem::Resolv::DNS IPv4 address.

Constant Summary collapse

Regex256 = 
/0
|1(?:[0-9][0-9]?)?
|2(?:[0-4][0-9]?|5[0-5]?|[6-9])?
|[3-9][0-9]?/x
Regex =

Regular expression IPv4 addresses must match.

/\A(#{Regex256})\.(#{Regex256})\.(#{Regex256})\.(#{Regex256})\z/

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(address) ⇒ IPv4

:nodoc:



2963
2964
2965
2966
2967
2968
2969
2970
2971
 
# File 'lib/rubygems/vendor/resolv/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

Instance Attribute Details

#address ⇒ Object (readonly)

The raw IPv4 address as a String.



2979
2980
2981
 
# File 'lib/rubygems/vendor/resolv/lib/resolv.rb', line 2979

def address
  @address
end

Class Method Details

.create(arg) ⇒ Object

Creates a new IPv4 address from arg which may be:

IPv4

returns arg.

String

arg must match the IPv4::Regex constant



2945
2946
2947
2948
2949
2950
2951
2952
2953
2954
2955
2956
2957
2958
2959
2960
2961
 
# File 'lib/rubygems/vendor/resolv/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 Method Details

#==(other) ⇒ Object

:nodoc:



2997
2998
2999
 
# File 'lib/rubygems/vendor/resolv/lib/resolv.rb', line 2997

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

#eql?(other) ⇒ Boolean

:nodoc:

Returns:

  • (Boolean) 


3001
3002
3003
 
# File 'lib/rubygems/vendor/resolv/lib/resolv.rb', line 3001

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

#hash ⇒ Object

:nodoc:



3005
3006
3007
 
# File 'lib/rubygems/vendor/resolv/lib/resolv.rb', line 3005

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

#inspect ⇒ Object

:nodoc:



2985
2986
2987
 
# File 'lib/rubygems/vendor/resolv/lib/resolv.rb', line 2985

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

#to_name ⇒ Object

Turns this IPv4 address into a Gem::Resolv::DNS::Name.



2992
2993
2994
2995
 
# File 'lib/rubygems/vendor/resolv/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 ⇒ Object

:nodoc:



2981
2982
2983
 
# File 'lib/rubygems/vendor/resolv/lib/resolv.rb', line 2981

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