Class Resolv::IPv6
In: lib/resolv.rb
Parent: Object

A Resolv::DNS IPv6 address.

Methods

create   to_name  

Constants

Regex_8Hex = /\A (?:[0-9A-Fa-f]{1,4}:){7} [0-9A-Fa-f]{1,4} \z/x   IPv6 address format a:b:c:d:e:f:g:h
Regex_CompressedHex = /\A ((?:[0-9A-Fa-f]{1,4}(?::[0-9A-Fa-f]{1,4})*)?) :: ((?:[0-9A-Fa-f]{1,4}(?::[0-9A-Fa-f]{1,4})*)?) \z/x   Compressed IPv6 address format a::b
Regex_6Hex4Dec = /\A ((?:[0-9A-Fa-f]{1,4}:){6,6}) (\d+)\.(\d+)\.(\d+)\.(\d+) \z/x   IPv4 mapped IPv6 address format a:b:c:d:e:f:w.x.y.z
Regex_CompressedHex4Dec = /\A ((?:[0-9A-Fa-f]{1,4}(?::[0-9A-Fa-f]{1,4})*)?) :: ((?:[0-9A-Fa-f]{1,4}:)*) (\d+)\.(\d+)\.(\d+)\.(\d+) \z/x   Compressed IPv4 mapped IPv6 address format a::b:w.x.y.z
Regex = / (?:#{Regex_8Hex}) | (?:#{Regex_CompressedHex}) | (?:#{Regex_6Hex4Dec}) | (?:#{Regex_CompressedHex4Dec})/x   A composite IPv6 address Regexp.

Attributes

address  [R]  The raw IPv6 address as a String.

Public Class methods

create(arg)

Creates a new IPv6 address from arg which may be:

IPv6:returns arg.
String:arg must match one of the IPv6::Regex* constants

[Source]

      # File lib/resolv.rb, line 2189
2189:     def self.create(arg)
2190:       case arg
2191:       when IPv6
2192:         return arg
2193:       when String
2194:         address = ''
2195:         if Regex_8Hex =~ arg
2196:           arg.scan(/[0-9A-Fa-f]+/) {|hex| address << [hex.hex].pack('n')}
2197:         elsif Regex_CompressedHex =~ arg
2198:           prefix = $1
2199:           suffix = $2
2200:           a1 = ''
2201:           a2 = ''
2202:           prefix.scan(/[0-9A-Fa-f]+/) {|hex| a1 << [hex.hex].pack('n')}
2203:           suffix.scan(/[0-9A-Fa-f]+/) {|hex| a2 << [hex.hex].pack('n')}
2204:           omitlen = 16 - a1.length - a2.length
2205:           address << a1 << "\0" * omitlen << a2
2206:         elsif Regex_6Hex4Dec =~ arg
2207:           prefix, a, b, c, d = $1, $2.to_i, $3.to_i, $4.to_i, $5.to_i
2208:           if (0..255) === a && (0..255) === b && (0..255) === c && (0..255) === d
2209:             prefix.scan(/[0-9A-Fa-f]+/) {|hex| address << [hex.hex].pack('n')}
2210:             address << [a, b, c, d].pack('CCCC')
2211:           else
2212:             raise ArgumentError.new("not numeric IPv6 address: " + arg)
2213:           end
2214:         elsif Regex_CompressedHex4Dec =~ arg
2215:           prefix, suffix, a, b, c, d = $1, $2, $3.to_i, $4.to_i, $5.to_i, $6.to_i
2216:           if (0..255) === a && (0..255) === b && (0..255) === c && (0..255) === d
2217:             a1 = ''
2218:             a2 = ''
2219:             prefix.scan(/[0-9A-Fa-f]+/) {|hex| a1 << [hex.hex].pack('n')}
2220:             suffix.scan(/[0-9A-Fa-f]+/) {|hex| a2 << [hex.hex].pack('n')}
2221:             omitlen = 12 - a1.length - a2.length
2222:             address << a1 << "\0" * omitlen << a2 << [a, b, c, d].pack('CCCC')
2223:           else
2224:             raise ArgumentError.new("not numeric IPv6 address: " + arg)
2225:           end
2226:         else
2227:           raise ArgumentError.new("not numeric IPv6 address: " + arg)
2228:         end
2229:         return IPv6.new(address)
2230:       else
2231:         raise ArgumentError.new("cannot interpret as IPv6 address: #{arg.inspect}")
2232:       end
2233:     end

Public Instance methods

to_name()

Turns this IPv6 address into a Resolv::DNS::Name.

[Source]

      # File lib/resolv.rb, line 2264
2264:     def to_name
2265:       return DNS::Name.new(
2266:         @address.unpack("H32")[0].split(//).reverse + ['ip6', 'arpa'])
2267:     end

[Validate]