inet.ipaddr.format

Class IPAddressLargeDivision

java.lang.Object

inet.ipaddr.format.AddressDivisionBase

inet.ipaddr.format.IPAddressLargeDivision

All Implemented Interfaces:

AddressItem, AddressStringDivision, IPAddressStringDivision, java.io.Serializable

public class IPAddressLargeDivision
extends AddressDivisionBase
implements IPAddressStringDivision

This class supports a segment or division of an arbitrary number of bits.

For a bit count less than or equal to 63 bits, AddressDivision or IPAddressDivision is a more efficient choice, which are based on arithmetic using longs and can be grouped with AddressDivisionGrouping and IPAddressDivisionGrouping respectively. IPAddressLargeDivision can only be grouped together in IPAddressStringDivisionGrouping, which is intended for producing strings.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static char[]	EXTENDED_DIGITS
static char	EXTENDED_DIGITS_RANGE_SEPARATOR
static java.lang.String	EXTENDED_DIGITS_RANGE_SEPARATOR_STR

Constructor Summary

Constructors

Constructor and Description
IPAddressLargeDivision(byte[] bytes, byte[] upperBytes, int bitCount, int defaultRadix, IPAddressNetwork<?,?,?,?,?> network, java.lang.Integer prefixLength)
IPAddressLargeDivision(byte[] bytes, int bitCount, int defaultRadix)
IPAddressLargeDivision(byte[] bytes, int bitCount, int defaultRadix, IPAddressNetwork<?,?,?,?,?> network, java.lang.Integer prefixLength)

Method Summary

Modifier and Type	Method and Description
int	getBitCount()
java.math.BigInteger	getCount() The count of possible distinct values for this AddressComponent.
int	getDefaultTextualRadix()
int	getDigitCount(int radix) Returns the count of digits of the value, or if a range, the larger value in the range
java.lang.Integer	getDivisionPrefixLength()
int	getMaxDigitCount()
int	getMaxDigitCount(int radix) Returns the count of digits of the largest possible value
int	getPrefixAdjustedRangeString(int segmentIndex, AddressSegmentParams params, java.lang.StringBuilder appendable) Produces a string to represent the segment of the form a-b where the value b has been adjusted for the prefix, anything beyond the prefix length being zero.
java.lang.String	getString() Produces a normalized string to represent the segment.
java.lang.String	getWildcardString() Produces a string to represent the segment, favouring wildcards and range characters over the network prefix to represent subnets.
boolean	includesMax()
boolean	includesZero()
boolean	isBoundedBy(int val) Returns true if the possible values of this division fall below the given boundary value.
boolean	isFullRange()
boolean	isMax()
boolean	isMultiple() Whether this represents multiple potential values (eg a prefixed address or a segment representing a range of values)
boolean	isPrefixBlock() Returns whether the division range includes the block of values for its prefix length
boolean	isPrefixBlock(int divisionPrefixLen)
boolean	isPrefixed()
boolean	isSinglePrefixBlock() Returns whether the division range matches the block of values for its prefix length
boolean	isZero()

Methods inherited from class inet.ipaddr.format.AddressDivisionBase

getBytes, getBytes, getBytes, getDigitCount, getLowerStandardString, getStandardString, getUpperBytes, getUpperBytes, getUpperBytes, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface inet.ipaddr.format.AddressStringDivision

getLowerStandardString, getStandardString

Field Detail

EXTENDED_DIGITS_RANGE_SEPARATOR

public static final char EXTENDED_DIGITS_RANGE_SEPARATOR

See Also:

Constant Field Values

EXTENDED_DIGITS_RANGE_SEPARATOR_STR

public static final java.lang.String EXTENDED_DIGITS_RANGE_SEPARATOR_STR

EXTENDED_DIGITS

public static final char[] EXTENDED_DIGITS

Constructor Detail

IPAddressLargeDivision

public IPAddressLargeDivision(byte[] bytes,
                              int bitCount,
                              int defaultRadix)
                       throws AddressValueException

Throws:

AddressValueException

IPAddressLargeDivision

public IPAddressLargeDivision(byte[] bytes,
                              int bitCount,
                              int defaultRadix,
                              IPAddressNetwork<?,?,?,?,?> network,
                              java.lang.Integer prefixLength)
                       throws AddressValueException

Parameters:

bytes -

bitCount -

defaultRadix -

network - can be null if prefixLength is null

prefixLength -

Throws:

AddressValueException

IPAddressLargeDivision

public IPAddressLargeDivision(byte[] bytes,
                              byte[] upperBytes,
                              int bitCount,
                              int defaultRadix,
                              IPAddressNetwork<?,?,?,?,?> network,
                              java.lang.Integer prefixLength)
                       throws AddressValueException

Throws:

AddressValueException

Method Detail

isBoundedBy

public boolean isBoundedBy(int val)

Description copied from interface: AddressStringDivision

Returns true if the possible values of this division fall below the given boundary value.

Specified by:

isBoundedBy in interface AddressStringDivision

getDigitCount

public int getDigitCount(int radix)

Description copied from interface: AddressStringDivision

Returns the count of digits of the value, or if a range, the larger value in the range

Specified by:

getDigitCount in interface AddressStringDivision

Returns:

getCount

public java.math.BigInteger getCount()

Description copied from interface: AddressItem

The count of possible distinct values for this AddressComponent. If not multiple, this is 1. For instance, if this is the ip address series subnet 0::/64, then the count is 2 to the power of 64. If this is a the segment 3-7, then the count is 5.

Specified by:

getCount in interface AddressItem

Returns:

getBitCount

public int getBitCount()

Specified by:

getBitCount in interface AddressItem

Specified by:

getBitCount in interface IPAddressStringDivision

Returns:

the number of bits comprising this address item

isMultiple

public boolean isMultiple()

Description copied from interface: AddressItem

Whether this represents multiple potential values (eg a prefixed address or a segment representing a range of values)

Specified by:

isMultiple in interface AddressItem

includesZero

public boolean includesZero()

Specified by:

includesZero in interface AddressItem

Returns:

whether this item includes the value of zero within its range

includesMax

public boolean includesMax()

Specified by:

includesMax in interface AddressItem

Returns:

whether this item includes the maximum possible value within its range

isMax

public boolean isMax()

Specified by:

isMax in interface AddressItem

Returns:

whether this item matches the maximum possible value

isZero

public boolean isZero()

Specified by:

isZero in interface AddressItem

Returns:

whether this item matches the value of zero

isFullRange

public boolean isFullRange()

Specified by:

isFullRange in interface AddressItem

Specified by:

isFullRange in interface IPAddressStringDivision

Returns:

whether this address item represents all possible values attainable by an address item of this type, or in other words, both includesZero() and includesMax() return true

getDefaultTextualRadix

public int getDefaultTextualRadix()

Specified by:

getDefaultTextualRadix in class AddressDivisionBase

Returns:

the default radix for textual representations of addresses (10 for IPv4, 16 for IPv6)

getMaxDigitCount

public int getMaxDigitCount()

Specified by:

getMaxDigitCount in class AddressDivisionBase

Returns:

the number of digits for the maximum possible value of the division when using the default radix

getMaxDigitCount

public int getMaxDigitCount(int radix)

Description copied from interface: AddressStringDivision

Returns the count of digits of the largest possible value

Specified by:

getMaxDigitCount in interface AddressStringDivision

Returns:

getString

public java.lang.String getString()

Produces a normalized string to represent the segment. If the segment CIDR prefix length covers the range, then it is assumed to be a CIDR, and the string has only the lower value of the CIDR range. Otherwise, the explicit range will be printed.

Overrides:

getString in class AddressDivisionBase

Returns:

getWildcardString

public java.lang.String getWildcardString()

Produces a string to represent the segment, favouring wildcards and range characters over the network prefix to represent subnets. If it exists, the segment CIDR prefix is ignored and the explicit range is printed.

Returns:

getPrefixAdjustedRangeString

public int getPrefixAdjustedRangeString(int segmentIndex,
                                        AddressSegmentParams params,
                                        java.lang.StringBuilder appendable)

Description copied from interface: IPAddressStringDivision

Produces a string to represent the segment of the form a-b where the value b has been adjusted for the prefix, anything beyond the prefix length being zero.

Specified by:

getPrefixAdjustedRangeString in interface IPAddressStringDivision

Returns:

if the supplied appendable is null, returns the length of the string that would have been appended, otherwise returns 0

isPrefixBlock

public boolean isPrefixBlock()

Description copied from interface: IPAddressStringDivision

Returns whether the division range includes the block of values for its prefix length

Specified by:

isPrefixBlock in interface IPAddressStringDivision

isSinglePrefixBlock

public boolean isSinglePrefixBlock()

Returns whether the division range matches the block of values for its prefix length

Specified by:

isSinglePrefixBlock in interface IPAddressStringDivision

getDivisionPrefixLength

public java.lang.Integer getDivisionPrefixLength()

Specified by:

getDivisionPrefixLength in interface IPAddressStringDivision

isPrefixed

public boolean isPrefixed()

isPrefixBlock

public boolean isPrefixBlock(int divisionPrefixLen)