public abstract class IPAddressSegment extends IPAddressDivision implements AddressSegment
AddressDivision.BitwiseOrResult, AddressDivision.MaskResult
EXTENDED_DIGITS
Modifier and Type | Method and Description |
---|---|
AddressDivision.BitwiseOrResult |
bitwiseOrRange(int maskValue) |
static int |
getBitCount(IPAddress.IPVersion version) |
static int |
getByteCount(IPAddress.IPVersion version) |
BigInteger |
getCount()
The count of possible distinct values for this AddressComponent.
|
static int |
getDefaultTextualRadix(IPAddress.IPVersion version) |
long |
getDivisionValue()
returns the lower value as a long, although for individual segments
getSegmentValue() provides the same value as an int |
abstract IPAddress.IPVersion |
getIPVersion() |
abstract Iterable<? extends IPAddressSegment> |
getIterable()
Useful for using an instance in a "for-each loop".
|
abstract IPAddressSegment |
getLower()
If this segment represents a range of values, returns a segment representing just the lowest value in the range, otherwise returns this.
|
static int |
getMaxSegmentValue(IPAddress.IPVersion version) |
long |
getMaxValue() |
int |
getMinPrefixLengthForBlock()
Returns the smallest prefix length possible such that this item includes the block of all values for that prefix length.
|
abstract IPAddressNetwork<?,?,?,?,?> |
getNetwork()
Returns the network object for components of the same version (eg IPv4, IPv6 and MAC each have their own network object)
|
BigInteger |
getPrefixCount(int segmentPrefixLength)
The count of the number of distinct values within the prefix part of the address item, the bits that appear within the prefix length.
|
int |
getPrefixValueCount()
Counts the number of prefixes in this address segment.
|
int |
getPrefixValueCount(int segmentPrefixLength)
Returns the count of prefix values in this address segment for the given prefix bit count.
|
Integer |
getSegmentPrefixLength() |
int |
getSegmentValue()
returns the lower value
|
abstract IPAddressSegment |
getUpper()
If this segment represents a range of values, returns a segment representing just the highest value in the range, otherwise returns this.
|
long |
getUpperDivisionValue()
returns the lower upper value as a long, although for individual segments
getUpperSegmentValue() provides the same value as an int |
int |
getUpperSegmentValue()
returns the upper value
|
int |
getValueCount()
Returns the count of values in this address segment.
|
int |
hashCode() |
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 |
isIPv4() |
boolean |
isIPv6() |
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
|
abstract Iterator<? extends IPAddressSegment> |
iterator()
Iterates through the individual address components.
|
AddressDivision.MaskResult |
maskRange(int maskValue) |
boolean |
matches(int value) |
boolean |
matchesWithMask(int value,
int mask) |
boolean |
matchesWithMask(int lowerValue,
int upperValue,
int mask) |
boolean |
matchesWithPrefixMask(int value,
Integer segmentPrefixLength) |
abstract Iterator<? extends IPAddressSegment> |
prefixBlockIterator()
Iterates through the individual prefix blocks.
|
abstract Iterator<? extends IPAddressSegment> |
prefixBlockIterator(int prefixLength)
Iterates through the individual prefix blocks according to the given segment prefix length.
|
abstract AddressComponentSpliterator<? extends IPAddressSegment> |
prefixBlockSpliterator()
Partitions and traverses through the individual prefix blocks of this segment for its prefix length.
|
abstract AddressComponentSpliterator<? extends IPAddressSegment> |
prefixBlockSpliterator(int prefixLength)
Partitions and traverses through the individual prefix blocks for the given prefix length.
|
abstract Stream<? extends IPAddressSegment> |
prefixBlockStream()
Returns a sequential stream of the individual prefix blocks of this segment.
|
abstract Stream<? extends IPAddressSegment> |
prefixBlockStream(int prefixLength)
Returns a sequential stream of the individual prefix blocks for the given prefix length.
|
boolean |
prefixContains(IPAddressSegment other)
Using the prefix length of this segment, or the whole segment if it has no prefix length,
returns whether the prefix bit value ranges contain the same bits of the given segment.
|
boolean |
prefixContains(IPAddressSegment other,
int prefixLength)
Returns whether the given prefix bit value ranges contain the same bits of the given segment.
|
boolean |
prefixEquals(AddressSegment other,
int prefixLength)
Returns whether the given prefix bits match the same bits of the given segment.
|
boolean |
prefixEquals(IPAddressSegment other) |
abstract Iterator<? extends IPAddressSegment> |
prefixIterator()
Iterates through the individual prefixes.
|
abstract AddressComponentSpliterator<? extends IPAddressSegment> |
prefixSpliterator()
Partitions and traverses through the individual prefixes of this segment for its prefix length.
|
abstract Stream<? extends IPAddressSegment> |
prefixStream()
Returns a sequential stream of the individual prefixes of this segment.
|
abstract IPAddressSegment |
removePrefixLength()
Deprecated.
use
withoutPrefixLength() and toZeroHost() |
abstract IPAddressSegment |
removePrefixLength(boolean zeroed)
Deprecated.
use
toZeroHost() and withoutPrefixLength() |
abstract IPAddressSegment |
reverseBits(boolean perByte)
Returns a new AddressComponent with the bits reversed.
|
abstract IPAddressSegment |
reverseBytes()
Returns an AddressComponent with the bytes reversed.
|
abstract AddressComponentSpliterator<? extends IPAddressSegment> |
spliterator()
Partitions and traverses through the individual address components.
|
abstract Stream<? extends IPAddressSegment> |
stream()
Returns a sequential stream of the individual address components.
|
String |
toHexString(boolean with0xPrefix)
Writes this address component as a single hexadecimal value with always the exact same number of characters, with or without a preceding 0x prefix.
|
abstract IPAddressSegment |
toHostSegment(Integer segmentPrefixLength)
used by getHostSection, see
IPAddressSegmentSeries.getHostSection(int) |
IPAddressSegment |
toNetworkSegment(Integer segmentPrefixLength)
used by constructors of IPAddressSection, see
IPAddressSegmentSeries.getNetworkSection(int, boolean) |
abstract IPAddressSegment |
toNetworkSegment(Integer segmentPrefixLength,
boolean withPrefixLength)
used by getNetworkSection and by constructors of IPAddressSection, see
IPAddressSegmentSeries.getNetworkSection(int, boolean) |
String |
toNormalizedString()
Produces a string that is consistent for all address components of the same type and version,
and is also similar to the canonical string
AddressSegmentSeries.toCanonicalString() in AddressComponent instances that are also AddressSegmentSeries instances. |
String |
toNormalizedString(IPAddressSection.IPStringOptions options) |
abstract IPAddressSegment |
toZeroHost()
Returns a segment with the same network bits as this segment,
but with the host bits changed to 0.
|
abstract IPAddressSegment |
withoutPrefixLength()
Returns a segment with the same values but without a prefix length.
|
containsPrefixBlock, containsSinglePrefixBlock, getBlockMaskPrefixLength, getDivisionPrefixLength, getLeadingBitCount, getPrefixAdjustedRangeString, getString, getTrailingBitCount, getWildcardString, isPrefixed, isSinglePrefixBlock, matchesWithPrefixMask
bitwiseOrRange, equals, getDigitCount, getMaxDigitCount, getPrefixLengthForSingleBlock, getUpperValue, getValue, hasUppercaseVariations, isBitwiseOrCompatibleWithRange, isMaskCompatibleWithRange, isMax, isZero, maskRange, matches, matchesWithMask, matchesWithMask
getBytes, getBytes, getBytes, getDigitCount, getDigitCount, getLowerStandardString, getStandardString, getUpperBytes, getUpperBytes, getUpperBytes, toString
contains, equals, getMaxSegmentValue, isOneBit, overlaps, testBit
stream, stream
compareTo, containsPrefixBlock, containsSinglePrefixBlock, getBitCount, getBitsForCount, getBlockSize, getByteCount, getBytes, getBytes, getBytes, getPrefixLengthForSingleBlock, getUpperBytes, getUpperBytes, getUpperBytes, getUpperValue, getValue, isFullRange, isMax, isZero
getDigitCount, getLowerStandardString, getMaxDigitCount, getStandardString
isFullRange
getBitCount
public abstract IPAddressNetwork<?,?,?,?,?> getNetwork()
AddressComponent
getNetwork
in interface AddressComponent
public boolean isIPv4()
public boolean isIPv6()
public abstract IPAddress.IPVersion getIPVersion()
public int getMinPrefixLengthForBlock()
AddressItem
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.
getMinPrefixLengthForBlock
in interface AddressItem
getMinPrefixLengthForBlock
in class AddressDivision
public static int getMaxSegmentValue(IPAddress.IPVersion version)
public boolean isPrefixBlock()
IPAddressStringDivision
isPrefixBlock
in interface IPAddressStringDivision
isPrefixBlock
in class IPAddressDivision
public IPAddressSegment toNetworkSegment(Integer segmentPrefixLength)
IPAddressSegmentSeries.getNetworkSection(int, boolean)
public abstract IPAddressSegment toNetworkSegment(Integer segmentPrefixLength, boolean withPrefixLength)
IPAddressSegmentSeries.getNetworkSection(int, boolean)
public abstract IPAddressSegment toHostSegment(Integer segmentPrefixLength)
IPAddressSegmentSeries.getHostSection(int)
public AddressDivision.MaskResult maskRange(int maskValue)
public AddressDivision.BitwiseOrResult bitwiseOrRange(int maskValue)
public abstract IPAddressSegment getLower()
getLower
in interface AddressSegment
getLower
in interface AddressComponentRange
public abstract IPAddressSegment getUpper()
getUpper
in interface AddressSegment
getUpper
in interface AddressComponentRange
public abstract Iterable<? extends IPAddressSegment> getIterable()
AddressComponentRange
AddressComponentRange.iterator()
directly.getIterable
in interface AddressSegment
getIterable
in interface AddressComponentRange
public abstract Iterator<? extends IPAddressSegment> iterator()
AddressComponentRange
An address component can represent an individual segment, address, or section, or it can represent multiple, typically a subnet of addresses or a range of segment or section values.
Call AddressItem.isMultiple()
to determine if this instance represents multiple, or AddressItem.getCount()
for the count.
iterator
in interface AddressSegment
iterator
in interface AddressComponentRange
public abstract AddressComponentSpliterator<? extends IPAddressSegment> spliterator()
AddressComponentRange
spliterator
in interface AddressComponent
spliterator
in interface AddressSegment
spliterator
in interface AddressComponentRange
public abstract Stream<? extends IPAddressSegment> stream()
AddressComponentRange
BaseStream.parallel()
on the returned stream.stream
in interface AddressSegment
stream
in interface AddressComponentRange
public abstract Iterator<? extends IPAddressSegment> prefixBlockIterator()
If the series has no prefix length, then this is equivalent to iterator()
public abstract AddressComponentSpliterator<? extends IPAddressSegment> prefixBlockSpliterator()
public abstract Stream<? extends IPAddressSegment> prefixBlockStream()
BaseStream.parallel()
on the returned stream.public abstract Iterator<? extends IPAddressSegment> prefixIterator()
If the series has no prefix length, then this is equivalent to iterator()
public abstract AddressComponentSpliterator<? extends IPAddressSegment> prefixSpliterator()
public abstract Stream<? extends IPAddressSegment> prefixStream()
BaseStream.parallel()
on the returned stream.public abstract Iterator<? extends IPAddressSegment> prefixBlockIterator(int prefixLength)
public abstract AddressComponentSpliterator<? extends IPAddressSegment> prefixBlockSpliterator(int prefixLength)
public abstract Stream<? extends IPAddressSegment> prefixBlockStream(int prefixLength)
BaseStream.parallel()
on the returned stream.public static int getBitCount(IPAddress.IPVersion version)
public static int getByteCount(IPAddress.IPVersion version)
public static int getDefaultTextualRadix(IPAddress.IPVersion version)
public boolean matches(int value)
matches
in interface AddressSegment
public boolean matchesWithPrefixMask(int value, Integer segmentPrefixLength)
public boolean matchesWithMask(int value, int mask)
matchesWithMask
in interface AddressSegment
public boolean matchesWithMask(int lowerValue, int upperValue, int mask)
matchesWithMask
in interface AddressSegment
public int getValueCount()
AddressSegment
getValueCount
in interface AddressSegment
getCount()
as an integerpublic int getPrefixValueCount()
If this segment has no prefix length, this is equivalent to getValueCount()
public BigInteger getCount()
AddressItem
getCount
in interface AddressItem
public BigInteger getPrefixCount(int segmentPrefixLength)
AddressItem
getPrefixCount
in interface AddressItem
public int getPrefixValueCount(int segmentPrefixLength)
AddressSegment
getPrefixValueCount
in interface AddressSegment
public long getMaxValue()
getMaxValue
in class AddressDivision
public boolean isMultiple()
AddressItem
isMultiple
in interface AddressItem
isMultiple
in class AddressDivision
public int getSegmentValue()
getSegmentValue
in interface AddressSegment
public int getUpperSegmentValue()
getUpperSegmentValue
in interface AddressSegment
public long getDivisionValue()
getSegmentValue()
provides the same value as an intgetDivisionValue
in class AddressDivision
public long getUpperDivisionValue()
getUpperSegmentValue()
provides the same value as an intgetUpperDivisionValue
in class AddressDivision
public abstract IPAddressSegment reverseBits(boolean perByte)
AddressComponent
IncompatibleAddressException
. In a range the most significant bits stay constant
while the least significant bits range over different values, so reversing that scenario results in a series of non-consecutive values, in most cases,
which cannot be represented with a single AddressComponent object.
In such cases where isMultiple() is true, call iterator(), getLower(), getUpper() or some other methods to break the series down into a series representing a single value.
reverseBits
in interface AddressComponent
reverseBits
in interface AddressSegment
perByte
- if true, only the bits in each byte are reversed, if false, then all bits in the component are reversedpublic abstract IPAddressSegment reverseBytes()
AddressComponent
IncompatibleAddressException
. In a range the most significant bits stay constant
while the least significant bits range over different values, so reversing that scenario results in a series of non-consecutive values, in most cases,
which cannot be represented with a single AddressComponent object.
In such cases where isMultiple() is true, call iterator(), getLower(), getUpper() or some other methods to break the series down into a series representing a single value.
reverseBytes
in interface AddressComponent
reverseBytes
in interface AddressSegment
@Deprecated public abstract IPAddressSegment removePrefixLength()
withoutPrefixLength()
and toZeroHost()
public abstract IPAddressSegment toZeroHost()
If there is no prefix length associated with this segment, returns an all-zero segment.
This is nearly equivalent to doing the mask (see maskRange(int)
) of this segment
with the network mask for the given prefix length,
but when applying a mask to a range of values you can have a non-sequential result.
With this method, if the resulting series has a range of values, then the resulting series range boundaries will have host values of 0, but not necessarily all the intervening values.
For instance, the 1-byte segment range 4-7 with prefix length 6, when masked with 252 (the network mask) results in just the single value 4, matching the result of this method. The 1-byte segment range 4-8 with prefix length 6, when masked with 252 results in the two non-sequential values, 4 and 8, but the result of this method with prefix length 6 results in the range 4-8, the same as the original segment.
The default behaviour is that the resultant series will have the same prefix length.
The resultant series will not have a prefix length if AddressNetwork.getPrefixConfiguration()
is AddressNetwork.PrefixConfiguration.ALL_PREFIXED_ADDRESSES_ARE_SUBNETS
.
@Deprecated public abstract IPAddressSegment removePrefixLength(boolean zeroed)
toZeroHost()
and withoutPrefixLength()
zeroed
- public abstract IPAddressSegment withoutPrefixLength()
public boolean isBoundedBy(int value)
AddressDivision
isBoundedBy
in interface AddressStringDivision
isBoundedBy
in class AddressDivision
public Integer getSegmentPrefixLength()
public int hashCode()
hashCode
in class AddressDivision
public boolean prefixEquals(IPAddressSegment other)
public boolean prefixEquals(AddressSegment other, int prefixLength)
AddressSegment
prefixEquals
in interface AddressSegment
public boolean prefixContains(IPAddressSegment other)
other
- public boolean prefixContains(IPAddressSegment other, int prefixLength)
other
- prefixLength
- public boolean includesZero()
AddressItem
includesZero
in interface AddressItem
includesZero
in class AddressDivision
public boolean includesMax()
AddressItem
includesMax
in interface AddressItem
includesMax
in class AddressDivision
public String toHexString(boolean with0xPrefix)
AddressComponent
If this component represents a range of values outside of the network prefix length, then this is printed as a range of two hex values.
For instance, for IPv4 addresses there are 8 hex characters, for IPv6 addresses there are 32 hex characters.
toHexString
in interface AddressComponent
public String toNormalizedString()
AddressComponent
AddressSegmentSeries.toCanonicalString()
in AddressComponent
instances that are also AddressSegmentSeries
instances.toNormalizedString
in interface AddressComponent
public String toNormalizedString(IPAddressSection.IPStringOptions options)