AddressDivision (IPAddress javadoc by seancfoley)

java.lang.Object
- inet.ipaddr.format.AddressDivisionBase
- - inet.ipaddr.format.standard.AddressDivision

All Implemented Interfaces:

AddressGenericDivision, AddressItem, AddressStringDivision, java.io.Serializable, java.lang.Comparable<AddressItem>

Direct Known Subclasses:

AddressBitsDivision, IPAddressDivision, MACAddressSegment
```
public abstract class AddressDivision
extends AddressDivisionBase
```
A division of an address.

See Also:

Serialized Form

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`equals(java.lang.Object o)` Two divisions are equal if they: - they match type/version (ipv4, ipv6, mac, or a specific division class) - match bit counts - match values Prefix lengths, for those divisions that have them, are ignored.
`java.math.BigInteger`	`getCount()` The count of possible distinct values for this AddressComponent.
`int`	`getDigitCount(int radix)` Returns the count of digits of the value, or if a range, the larger value in the range
`long`	`getDivisionPrefixCount(int divisionPrefixLength)`
`abstract long`	`getDivisionValue()`
`long`	`getDivisionValueCount()`
`int`	`getMaxDigitCount(int radix)` Returns the count of digits of the largest possible value
`long`	`getMaxValue()`
`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 divisionPrefixLength)` 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.
`abstract long`	`getUpperDivisionValue()`
`java.math.BigInteger`	`getUpperValue()` Returns the highest value represented by this address item, the highest value included in the range of values
`java.math.BigInteger`	`getValue()` Returns the lowest value represented by this address item, the lowest value included in the range of values
`int`	`hashCode()`
`boolean`	`hasUppercaseVariations(int radix, boolean lowerOnly)`
`boolean`	`includesMax()` Returns whether this item includes the maximum possible value for the address type or version within its range
`boolean`	`includesZero()` Returns whether this item includes the value of zero within its range
`boolean`	`isBoundedBy(int value)` Returns true if the possible values of this division fall below the given value.
`boolean`	`isMax()` Returns whether this item matches the maximum possible value for the address type or version
`boolean`	`isMultiple()` Whether this represents multiple potential values (eg a prefixed address or a segment representing a range of values)
`boolean`	`isZero()` Returns whether this item matches the value of zero
`boolean`	`matches(long value)`
`boolean`	`matchesWithMask(long value, long mask)`
`boolean`	`matchesWithMask(long lowerValue, long upperValue, long mask)` returns whether masking with the given mask results in a valid contiguous range for this segment, and if it does, if it matches the range obtained when masking the given values with the same mask.

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
getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface inet.ipaddr.format.AddressItem
compareTo, containsPrefixBlock, containsSinglePrefixBlock, getBitCount, getByteCount, isFullRange, testRange, testRange

- Method Detail
  - 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)
    
    Returns:
    
    whether this segment represents multiple values
  - 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.
    
    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.
    
    Returns:
    
    the prefix length or null
  - getMaxValue
```
public long getMaxValue()
```
  - isZero
```
public boolean isZero()
```
    Description copied from interface: AddressItem
    
    Returns whether this item matches the value of zero
    
    Returns:
    
    whether this item matches the value of zero
  - includesZero
```
public boolean includesZero()
```
    Description copied from interface: AddressItem
    
    Returns whether this item includes the value of zero within its range
    
    Returns:
    
    whether this item includes the value of zero within its range
  - isMax
```
public boolean isMax()
```
    Description copied from interface: AddressItem
    
    Returns whether this item matches the maximum possible value for the address type or version
    
    Returns:
    
    whether this item matches the maximum possible value
  - includesMax
```
public boolean includesMax()
```
    Description copied from interface: AddressItem
    
    Returns whether this item includes the maximum possible value for the address type or version within its range
    
    Returns:
    
    whether this item includes the maximum possible value within its range
  - getDivisionValue
```
public abstract long getDivisionValue()
```
  - getUpperDivisionValue
```
public abstract long getUpperDivisionValue()
```
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class AddressDivisionBase
  - getValue
```
public java.math.BigInteger getValue()
```
    Description copied from interface: AddressItem
    
    Returns the lowest value represented by this address item, the lowest value included in the range of values
    
    Returns:
    
    the lowest value represented by this address item
  - getUpperValue
```
public java.math.BigInteger getUpperValue()
```
    Description copied from interface: AddressItem
    
    Returns the highest value represented by this address item, the highest value included in the range of values
    
    Returns:
    
    the highest value represented by this address item
  - getDivisionValueCount
```
public long getDivisionValueCount()
```
  - getPrefixCount
```
public java.math.BigInteger getPrefixCount(int divisionPrefixLength)
```
    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.
    
    Returns:
  - getDivisionPrefixCount
```
public long getDivisionPrefixCount(int divisionPrefixLength)
```
  - 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.
    
    Returns:
  - isBoundedBy
```
public boolean isBoundedBy(int value)
```
    Returns true if the possible values of this division fall below the given value.
  - matches
```
public boolean matches(long value)
```
  - matchesWithMask
```
public boolean matchesWithMask(long value,
                               long mask)
```
  - matchesWithMask
```
public boolean matchesWithMask(long lowerValue,
                               long upperValue,
                               long mask)
```
    returns whether masking with the given mask results in a valid contiguous range for this segment, and if it does, if it matches the range obtained when masking the given values with the same mask.
    
    Parameters:
    
    lowerValue -
    
    upperValue -
    
    mask -
    
    Returns:
  - equals
```
public boolean equals(java.lang.Object o)
```
    Description copied from class: AddressDivisionBase
    
    Two divisions are equal if they: - they match type/version (ipv4, ipv6, mac, or a specific division class) - match bit counts - match values Prefix lengths, for those divisions that have them, are ignored.
    
    Overrides:
    
    equals in class AddressDivisionBase
  - hasUppercaseVariations
```
public boolean hasUppercaseVariations(int radix,
                                      boolean lowerOnly)
```
  - 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
    
    Returns:
  - getMaxDigitCount
```
public int getMaxDigitCount(int radix)
```
    Description copied from interface: AddressStringDivision
    
    Returns the count of digits of the largest possible value
    
    Returns:

Class AddressDivision

Method Summary

Methods inherited from class inet.ipaddr.format.AddressDivisionBase

Methods inherited from class java.lang.Object

Methods inherited from interface inet.ipaddr.format.AddressItem

Method Detail

isMultiple

getMinPrefixLengthForBlock

getPrefixLengthForSingleBlock

getMaxValue

isZero

includesZero

isMax

includesMax

getDivisionValue

getUpperDivisionValue

hashCode

getValue

getUpperValue

getDivisionValueCount

getPrefixCount

getDivisionPrefixCount

getCount

isBoundedBy

matches

matchesWithMask

matchesWithMask

equals

hasUppercaseVariations

getDigitCount

getMaxDigitCount