inet.ipaddr.ipv4

Class IPv4AddressSeqRange

java.lang.Object

inet.ipaddr.IPAddressSeqRange

inet.ipaddr.ipv4.IPv4AddressSeqRange

All Implemented Interfaces:

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

public class IPv4AddressSeqRange
extends IPAddressSeqRange
implements java.lang.Iterable<IPv4Address>

See Also:

Serialized Form

Core

Constructor Summary

Constructors

Constructor and Description
IPv4AddressSeqRange(IPv4Address first, IPv4Address second)

Method Summary

Modifier and Type	Method and Description
long	getIPv4Count() Equivalent to IPAddressSeqRange.getCount() but returns a long
long	getIPv4PrefixCount(int prefixLength) Equivalent to getPrefixCount(int) but returns a long
java.lang.Iterable<IPv4Address>	getIterable() Useful for using an instance in a "for-each loop", as in for(addr : address.getIterable()) { ...
IPv4Address	getLower() If this instance represents multiple individual addresses, returns the one with the lowest numeric value.
int	getMinPrefixLengthForBlock() Returns the smallest prefix length possible such that this item includes the block of all values for that prefix length.
java.math.BigInteger	getPrefixCount(int prefixLength) The count of the number of distinct values within the prefix part of the address item, the bits that appear within the prefix length.
java.lang.Integer	getPrefixLengthForSingleBlock() Returns a prefix length for which the range of this item matches the block of all values for that prefix length.
IPv4Address	getUpper() If this instance represents multiple individual addresses, returns the one with the highest numeric value.
IPv4AddressSeqRange	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<IPv4Address>	iterator() Iterates through the individual addresses of this address or subnet.
IPv4AddressSeqRange	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<IPv4Address>	prefixBlockIterator(int prefLength) Iterates through the range of prefix blocks in this range instance using the given prefix length.
java.util.Iterator<IPv4AddressSeqRange>	prefixIterator(int prefixLength) Iterates through the range of prefixes in this range instance using the given prefix length.
IPv4Address[]	spanWithPrefixBlocks() Produces an array of prefix blocks that cover the same set of addresses.
IPv4Address[]	spanWithSequentialBlocks() Produces an array of blocks that are sequential that cover the same set of addresses.
IPv4AddressSeqRange[]	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	toIPv4String(java.util.function.Function<IPv4Address,java.lang.String> lowerStringer, java.lang.String separator, java.util.function.Function<IPv4Address,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, isFullRange, testRange, testRange

Constructor Detail

IPv4AddressSeqRange

public IPv4AddressSeqRange(IPv4Address first,
                           IPv4Address second)

Method Detail

getLower

public IPv4Address 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 IPv4Address 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:

getIPv4Count

public long getIPv4Count()

Equivalent to IPAddressSeqRange.getCount() but returns a long

Returns:

getIPv4PrefixCount

public long getIPv4PrefixCount(int prefixLength)

Equivalent to getPrefixCount(int) but returns a long

Returns:

getPrefixCount

public java.math.BigInteger getPrefixCount(int prefixLength)

Description copied from interface: AddressItem

The count of the number of distinct values within the prefix part of the address item, the bits that appear within the prefix length.

Specified by:

getPrefixCount in interface AddressItem

Returns:

getIterable

public java.lang.Iterable<IPv4Address> 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<IPv4Address> 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<IPv4Address>

Specified by:

iterator in class IPAddressSeqRange

Returns:

prefixBlockIterator

public java.util.Iterator<IPv4Address> 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<IPv4AddressSeqRange> 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:

spanWithPrefixBlocks

public IPv4Address[] 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 IPv4Address[] 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

getMinPrefixLengthForBlock

public int getMinPrefixLengthForBlock()

Description copied from interface: AddressItem

Returns the smallest prefix length possible such that this item includes the block of all values for that prefix length.

If the entire range can be dictated this way, then this method returns the same value as AddressItem.getPrefixLengthForSingleBlock(). Otherwise, this method will return the minimal possible prefix that can be paired with this address, while AddressItem.getPrefixLengthForSingleBlock() will return null.

In cases where the final bit is constant so there is no such block, this returns the bit count.

Specified by:

getMinPrefixLengthForBlock in interface AddressItem

Returns:

the prefix length

getPrefixLengthForSingleBlock

public java.lang.Integer getPrefixLengthForSingleBlock()

Description copied from interface: AddressItem

Returns a prefix length for which the range of this item matches the block of all values for that prefix length.

If the range can be dictated this way, then this method returns the same value as AddressItem.getMinPrefixLengthForBlock().

If no such prefix length exists, returns null.

If this item represents a single value, this returns the bit count.

Specified by:

getPrefixLengthForSingleBlock in interface AddressItem

Returns:

the prefix length or null

toIPv4String

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

intersect

public IPv4AddressSeqRange 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 IPv4AddressSeqRange 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 IPv4AddressSeqRange[] 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: