inet.ipaddr.ipv6

Class IPv6AddressSeqRange

java.lang.Object

inet.ipaddr.IPAddressSeqRange

inet.ipaddr.ipv6.IPv6AddressSeqRange

All Implemented Interfaces:

AddressItem, AddressItemRange, IPAddressRange, java.io.Serializable, java.lang.Comparable<AddressItem>, java.lang.Iterable<IPv6Address>

public class IPv6AddressSeqRange
extends IPAddressSeqRange
implements java.lang.Iterable<IPv6Address>

See Also:

Serialized Form

Core

Constructor Summary

Constructors

Constructor and Description
IPv6AddressSeqRange(IPv6Address first, IPv6Address second)

Method Summary

Modifier and Type	Method and Description
java.lang.Iterable<IPv6Address>	getIterable() Useful for using an instance in a "for-each loop", as in for(addr : address.getIterable()) { ...
IPv6Address	getLower() If this instance represents multiple individual addresses, returns the one with the lowest numeric value.
IPv6Address	getUpper() If this instance represents multiple individual addresses, returns the one with the highest numeric value.
IPv6AddressSeqRange	intersect(IPAddressSeqRange other) Returns the intersection of this range with the given range, a range which includes those addresses in both this and the given rqnge.
java.util.Iterator<IPv6Address>	iterator() Iterates through the individual addresses of this address or subnet.
IPv6AddressSeqRange	join(IPAddressSeqRange other) If this range overlaps with the given range, or if the highest value of the lower range is one below the lowest value of the higher range, then the two are joined into a new larger range that is returned.
java.util.Iterator<? extends IPAddress>	prefixBlockIterator(int prefLength) Iterates through the range of prefix blocks in this range instance using the given prefix length.
java.util.Iterator<IPv6AddressSeqRange>	prefixIterator(int prefixLength) Iterates through the range of prefixes in this range instance using the given prefix length.
IPv6Address[]	spanWithPrefixBlocks() Produces an array of prefix blocks that cover the same set of addresses.
IPv6Address[]	spanWithSequentialBlocks() Produces an array of blocks that are sequential that cover the same set of addresses.
IPv6AddressSeqRange[]	subtract(IPAddressSeqRange other) Subtracts the given range from this range, to produce either zero, one, or two address ranges that contain the addresses in this range and not in the given range.
java.lang.String	toIPv6String(java.util.function.Function<IPv6Address,java.lang.String> lowerStringer, java.lang.String separator, java.util.function.Function<IPv6Address,java.lang.String> upperStringer)

Methods inherited from class inet.ipaddr.IPAddressSeqRange

contains, contains, containsPrefixBlock, containsSinglePrefixBlock, equals, getBitCount, getBytes, getBytes, getBytes, getCount, getUpperBytes, getUpperBytes, getUpperBytes, getUpperValue, getValue, hashCode, includesMax, includesZero, isMax, isMore, isMultiple, isZero, join, overlaps, toCanonicalString, toCanonicalString, toNormalizedString, toNormalizedString, toString, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface inet.ipaddr.format.AddressItem

compareTo, getByteCount, getMinPrefixLengthForBlock, getPrefixCount, getPrefixLengthForSingleBlock, isFullRange, testRange, testRange

Constructor Detail

IPv6AddressSeqRange

public IPv6AddressSeqRange(IPv6Address first,
                           IPv6Address second)

Method Detail

getLower

public IPv6Address getLower()

Description copied from interface: IPAddressRange

If this instance represents multiple individual addresses, returns the one with the lowest numeric value.

Specified by:

getLower in interface AddressItemRange

Specified by:

getLower in interface IPAddressRange

Overrides:

getLower in class IPAddressSeqRange

Returns:

getUpper

public IPv6Address getUpper()

Description copied from interface: IPAddressRange

If this instance represents multiple individual addresses, returns the one with the highest numeric value.

Specified by:

getUpper in interface AddressItemRange

Specified by:

getUpper in interface IPAddressRange

Overrides:

getUpper in class IPAddressSeqRange

Returns:

getIterable

public java.lang.Iterable<IPv6Address> getIterable()

Description copied from interface: IPAddressRange

Useful for using an instance in a "for-each loop", as in for(addr : address.getIterable()) { ... }

Otherwise just call IPAddressRange.iterator() directly.

Specified by:

getIterable in interface AddressItemRange

Specified by:

getIterable in interface IPAddressRange

Specified by:

getIterable in class IPAddressSeqRange

Returns:

iterator

public java.util.Iterator<IPv6Address> iterator()

Description copied from interface: IPAddressRange

Iterates through the individual addresses of this address or subnet.

Call AddressItem.isMultiple() to determine if this instance represents multiple, or AddressItem.getCount() for the count.

Specified by:

iterator in interface AddressItemRange

Specified by:

iterator in interface IPAddressRange

Specified by:

iterator in interface java.lang.Iterable<IPv6Address>

Specified by:

iterator in class IPAddressSeqRange

Returns:

spanWithPrefixBlocks

public IPv6Address[] spanWithPrefixBlocks()

Description copied from interface: IPAddressRange

Produces an array of prefix blocks that cover the same set of addresses.

Specified by:

spanWithPrefixBlocks in interface IPAddressRange

Specified by:

spanWithPrefixBlocks in class IPAddressSeqRange

spanWithSequentialBlocks

public IPv6Address[] spanWithSequentialBlocks()

Description copied from interface: IPAddressRange

Produces an array of blocks that are sequential that cover the same set of addresses. This array can be shorter than that produced by IPAddressRange.spanWithPrefixBlocks() and is never longer.

Specified by:

spanWithSequentialBlocks in interface IPAddressRange

Specified by:

spanWithSequentialBlocks in class IPAddressSeqRange

prefixBlockIterator

public java.util.Iterator<? extends IPAddress> prefixBlockIterator(int prefLength)

Description copied from class: IPAddressSeqRange

Iterates through the range of prefix blocks in this range instance using the given prefix length.

Specified by:

prefixBlockIterator in interface IPAddressRange

Specified by:

prefixBlockIterator in class IPAddressSeqRange

Returns:

prefixIterator

public java.util.Iterator<IPv6AddressSeqRange> prefixIterator(int prefixLength)

Description copied from class: IPAddressSeqRange

Iterates through the range of prefixes in this range instance using the given prefix length.

Specified by:

prefixIterator in interface IPAddressRange

Overrides:

prefixIterator in class IPAddressSeqRange

Returns:

toIPv6String

public java.lang.String toIPv6String(java.util.function.Function<IPv6Address,java.lang.String> lowerStringer,
                                     java.lang.String separator,
                                     java.util.function.Function<IPv6Address,java.lang.String> upperStringer)

intersect

public IPv6AddressSeqRange intersect(IPAddressSeqRange other)

Description copied from class: IPAddressSeqRange

Returns the intersection of this range with the given range, a range which includes those addresses in both this and the given rqnge.

Overrides:

intersect in class IPAddressSeqRange

Returns:

join

public IPv6AddressSeqRange join(IPAddressSeqRange other)

Description copied from class: IPAddressSeqRange

If this range overlaps with the given range, or if the highest value of the lower range is one below the lowest value of the higher range, then the two are joined into a new larger range that is returned.

Otherwise null is returned.

Overrides:

join in class IPAddressSeqRange

Returns:

subtract

public IPv6AddressSeqRange[] subtract(IPAddressSeqRange other)

Description copied from class: IPAddressSeqRange

Subtracts the given range from this range, to produce either zero, one, or two address ranges that contain the addresses in this range and not in the given range. If the result has length 2, the two ranges are in increasing order.

Overrides:

subtract in class IPAddressSeqRange

Returns: