Class IPv6AddressSegment

java.lang.Object

inet.ipaddr.format.AddressDivisionBase

inet.ipaddr.format.standard.AddressDivision

inet.ipaddr.format.standard.IPAddressDivision

inet.ipaddr.IPAddressSegment

inet.ipaddr.ipv6.IPv6AddressSegment

All Implemented Interfaces:

AddressComponent, AddressSegment, AddressComponentRange, AddressGenericDivision, AddressItem, AddressItemRange, IPAddressGenericDivision, AddressStringDivision, IPAddressStringDivision, Serializable, Comparable<AddressItem>, Iterable<IPv6AddressSegment>

public class IPv6AddressSegment
extends IPAddressSegment
implements Iterable<IPv6AddressSegment>

This represents a segment of an IPv6 address. For IPv4, segments are 1 byte. For IPv6, they are two bytes. Like String and Integer and various others basic objects, segments are immutable, which also makes them thread-safe.

Author:

sfoley

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class AddressDivision

AddressDivision.BitwiseOrResult, AddressDivision.MaskResult

Field Summary

Fields

Modifier and Type	Field	Description
static final int	BITS_PER_CHAR
static final int	MAX_CHARS

Fields inherited from class AddressDivisionBase

EXTENDED_DIGITS

Constructor Summary

Constructors

Constructor	Description
IPv6AddressSegment(int value)	Constructs a segment of an IPv6 address with the given value.
IPv6AddressSegment(int lower, int upper, Integer segmentPrefixLength)	Constructs a segment of an IPv6 address with the given range of values.
IPv6AddressSegment(int value, Integer segmentPrefixLength)	Constructs a segment of an IPv6 address.

Method Summary

Modifier and Type	Method	Description
boolean	contains(AddressSegment other)
boolean	equals(Object other)	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.
int	getBitCount()	Provides the number of bits comprising this address item
int	getByteCount()	Provides the number of bytes required for this address item, rounding up if the bit count is not a multiple of 8
int	getDefaultTextualRadix()
IPAddress.IPVersion	getIPVersion()
Iterable<IPv6AddressSegment>	getIterable()	Useful for using an instance in a "for-each loop".
IPv6AddressSegment	getLower()	If this segment represents a range of values, returns a segment representing just the lowest value in the range, otherwise returns this.
int	getMaxDigitCount()
int	getMaxSegmentValue()	Gets the maximum possible value for this type of segment (for the highest range value of this particular segment, use AddressSegment.getUpper()
long	getMaxValue()
IPv6AddressNetwork	getNetwork()	Returns the network object for components of the same version (eg IPv4, IPv6 and MAC each have their own network object)
<S extends AddressSegment> void	getSplitSegments(S[] segs, int index, AddressNetwork.AddressSegmentCreator<S> creator)	Converts this IPv6 address segment into smaller segments, copying them into the given array starting at the given index.
IPv6AddressSegment	getUpper()	If this segment represents a range of values, returns a segment representing just the highest value in the range, otherwise returns this.
boolean	isIPv6()
Iterator<IPv6AddressSegment>	iterator()	Iterates through the individual address components.
boolean	overlaps(AddressSegment other)
Iterator<IPv6AddressSegment>	prefixBlockIterator()	Iterates through the individual prefix blocks.
Iterator<IPv6AddressSegment>	prefixBlockIterator(int prefixLength)	Iterates through the individual prefix blocks according to the given segment prefix length.
AddressComponentSpliterator<IPv6AddressSegment>	prefixBlockSpliterator()	Partitions and traverses through the individual prefix blocks of this segment for its prefix length.
AddressComponentSpliterator<IPv6AddressSegment>	prefixBlockSpliterator(int segPrefLength)	Partitions and traverses through the individual prefix blocks for the given prefix length.
Stream<IPv6AddressSegment>	prefixBlockStream()	Returns a sequential stream of the individual prefix blocks of this segment.
Stream<IPv6AddressSegment>	prefixBlockStream(int segPrefLength)	Returns a sequential stream of the individual prefix blocks for the given prefix length.
boolean	prefixContains(IPAddressSegment other, int segmentPrefixLength)	Returns whether the given prefix bit value ranges contain the same bits of the given segment.
boolean	prefixEquals(AddressSegment other, int segmentPrefixLength)	Returns whether the given prefix bits match the same bits of the given segment.
Iterator<IPv6AddressSegment>	prefixIterator()	Iterates through the individual prefixes.
AddressComponentSpliterator<IPv6AddressSegment>	prefixSpliterator()	Partitions and traverses through the individual prefixes of this segment for its prefix length.
Stream<IPv6AddressSegment>	prefixStream()	Returns a sequential stream of the individual prefixes of this segment.
IPv6AddressSegment	removePrefixLength()	Deprecated.
IPv6AddressSegment	removePrefixLength(boolean zeroed)	Deprecated.
IPv6AddressSegment	reverseBits(boolean perByte)	Returns a new AddressComponent with the bits reversed.
IPv6AddressSegment	reverseBytes()	Returns an AddressComponent with the bytes reversed.
AddressComponentSpliterator<IPv6AddressSegment>	spliterator()	Partitions and traverses through the individual address components.
Stream<IPv6AddressSegment>	stream()	Returns a sequential stream of the individual address components.
IPv6AddressSegment	toHostSegment(Integer bits)	used by getHostSection, see IPAddressSegmentSeries.getHostSection(int)
IPv6AddressSegment	toNetworkSegment(Integer segmentPrefixLength)	used by constructors of IPAddressSection, see IPAddressSegmentSeries.getNetworkSection(int, boolean)
IPv6AddressSegment	toNetworkSegment(Integer segmentPrefixLength, boolean withPrefixLength)	used by getNetworkSection and by constructors of IPAddressSection, see IPAddressSegmentSeries.getNetworkSection(int, boolean)
IPv6AddressSegment	toZeroHost()	Returns a segment with the same network bits as this segment, but with the host bits changed to 0.
IPv6AddressSegment	withoutPrefixLength()	Returns a segment with the same values but without a prefix length.

Methods inherited from class IPAddressSegment

bitwiseOrRange, getBitCount, getByteCount, getCount, getDefaultTextualRadix, getDivisionValue, getMaxSegmentValue, getMinPrefixLengthForBlock, getPrefixCount, getPrefixValueCount, getPrefixValueCount, getSegmentPrefixLength, getSegmentValue, getUpperDivisionValue, getUpperSegmentValue, getValueCount, hashCode, includesMax, includesZero, isBoundedBy, isIPv4, isMultiple, isPrefixBlock, maskRange, matches, matchesWithMask, matchesWithMask, matchesWithPrefixMask, prefixContains, prefixEquals, toHexString, toNormalizedString, toNormalizedString

Methods inherited from class IPAddressDivision

containsPrefixBlock, containsSinglePrefixBlock, getBlockMaskPrefixLength, getDivisionPrefixLength, getLeadingBitCount, getPrefixAdjustedRangeString, getString, getTrailingBitCount, getWildcardString, isPrefixed, isSinglePrefixBlock, matchesWithPrefixMask

Methods inherited from class AddressDivision

bitwiseOrRange, getDigitCount, getMaxDigitCount, getPrefixLengthForSingleBlock, getUpperValue, getValue, hasUppercaseVariations, isBitwiseOrCompatibleWithRange, isMaskCompatibleWithRange, isMax, isZero, maskRange, matches, matchesWithMask, matchesWithMask

Methods inherited from class AddressDivisionBase

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

Methods inherited from class Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface AddressItem

compareTo, containsPrefixBlock, containsSinglePrefixBlock, getBytes, getBytes, getBytes, getPrefixLengthForSingleBlock, getUpperBytes, getUpperBytes, getUpperBytes, getUpperValue, getValue, isMax, isZero

Methods inherited from interface AddressSegment

isOneBit, testBit

Methods inherited from interface AddressStringDivision

getDigitCount, getLowerStandardString, getMaxDigitCount, getStandardString

Methods inherited from interface IPAddressGenericDivision

isFullRange

Methods inherited from interface Iterable

forEach

Field Details

MAX_CHARS

public static final int MAX_CHARS

See Also:

• Constant Field Values

BITS_PER_CHAR

public static final int BITS_PER_CHAR

See Also:

• Constant Field Values

Constructor Details

IPv6AddressSegment

public IPv6AddressSegment(int value)
                   throws AddressValueException

Constructs a segment of an IPv6 address with the given value.

Parameters:

value - the value of the segment

Throws:

AddressValueException - if value is negative or too large

IPv6AddressSegment

public IPv6AddressSegment(int value,
 Integer segmentPrefixLength)
                   throws AddressValueException

Constructs a segment of an IPv6 address.

Parameters:

value - the value of the segment. If the segmentPrefixLength is non-null, the network prefix of the value is used, and the segment represents all segment values with the same network prefix.

segmentPrefixLength - the segment prefix length, which can be null

Throws:

AddressValueException - if value or prefix length is negative or too large

IPv6AddressSegment

public IPv6AddressSegment(int lower,
 int upper,
 Integer segmentPrefixLength)
                   throws AddressValueException

Constructs a segment of an IPv6 address with the given range of values.

Parameters:

lower - the lower value of the range of values represented by the segment. If segmentPrefixLength is non-null, the lower value becomes the smallest value with the same network prefix.

upper - the upper value of the range of values represented by the segment. If segmentPrefixLength is non-null, the upper value becomes the largest value with the same network prefix.

segmentPrefixLength - the segment prefix length, which can be null. If segmentPrefixLength is non-null, this segment represents a range of segment values with the given network prefix length.

Throws:

AddressValueException - if value or prefix length is negative or too large

Method Details

getMaxValue

public long getMaxValue()

Overrides:

getMaxValue in class IPAddressSegment

isIPv6

public boolean isIPv6()

Overrides:

isIPv6 in class IPAddressSegment

getIPVersion

public IPAddress.IPVersion getIPVersion()

Specified by:

getIPVersion in class IPAddressSegment

getNetwork

public IPv6AddressNetwork getNetwork()

Description copied from interface: AddressComponent

Returns the network object for components of the same version (eg IPv4, IPv6 and MAC each have their own network object)

Specified by:

getNetwork in interface AddressComponent

Specified by:

getNetwork in class IPAddressSegment

Returns:

getMaxSegmentValue

public int getMaxSegmentValue()

Description copied from interface: AddressSegment

Gets the maximum possible value for this type of segment (for the highest range value of this particular segment, use AddressSegment.getUpper()

Specified by:

getMaxSegmentValue in interface AddressSegment

Returns:

toNetworkSegment

public IPv6AddressSegment toNetworkSegment(Integer segmentPrefixLength)

Description copied from class: IPAddressSegment

used by constructors of IPAddressSection, see IPAddressSegmentSeries.getNetworkSection(int, boolean)

Overrides:

toNetworkSegment in class IPAddressSegment

toNetworkSegment

public IPv6AddressSegment toNetworkSegment(Integer segmentPrefixLength,
 boolean withPrefixLength)

Description copied from class: IPAddressSegment

used by getNetworkSection and by constructors of IPAddressSection, see IPAddressSegmentSeries.getNetworkSection(int, boolean)

Specified by:

toNetworkSegment in class IPAddressSegment

toHostSegment

public IPv6AddressSegment toHostSegment(Integer bits)

Description copied from class: IPAddressSegment

used by getHostSection, see IPAddressSegmentSeries.getHostSection(int)

Specified by:

toHostSegment in class IPAddressSegment

getLower

public IPv6AddressSegment getLower()

Description copied from class: IPAddressSegment

If this segment represents a range of values, returns a segment representing just the lowest value in the range, otherwise returns this.

Specified by:

getLower in interface AddressComponentRange

Specified by:

getLower in interface AddressSegment

Specified by:

getLower in class IPAddressSegment

Returns:

getUpper

public IPv6AddressSegment getUpper()

Description copied from class: IPAddressSegment

If this segment represents a range of values, returns a segment representing just the highest value in the range, otherwise returns this.

Specified by:

getUpper in interface AddressComponentRange

Specified by:

getUpper in interface AddressSegment

Specified by:

getUpper in class IPAddressSegment

Returns:

reverseBits

public IPv6AddressSegment reverseBits(boolean perByte)

Description copied from interface: AddressComponent

Returns a new AddressComponent with the bits reversed. If this component represents a range of values that cannot be reversed, then this throws 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.

Specified by:

reverseBits in interface AddressComponent

Specified by:

reverseBits in interface AddressSegment

Specified by:

reverseBits in class IPAddressSegment

Parameters:

perByte - if true, only the bits in each byte are reversed, if false, then all bits in the component are reversed

Returns:

reverseBytes

public IPv6AddressSegment reverseBytes()

Description copied from interface: AddressComponent

Returns an AddressComponent with the bytes reversed. If this component represents a range of values that cannot be reversed, then this throws 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.

Specified by:

reverseBytes in interface AddressComponent

Specified by:

reverseBytes in interface AddressSegment

Specified by:

reverseBytes in class IPAddressSegment

Returns:

toZeroHost

public IPv6AddressSegment toZeroHost()

Description copied from class: IPAddressSegment

Returns a segment with the same network bits as this segment, but with the host bits changed to 0.

If there is no prefix length associated with this segment, returns an all-zero segment.

This is nearly equivalent to doing the mask (see IPAddressSegment.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.

Specified by:

toZeroHost in class IPAddressSegment

Returns:

removePrefixLength

@Deprecated
public IPv6AddressSegment removePrefixLength(boolean zeroed)

Deprecated.

Specified by:

removePrefixLength in class IPAddressSegment

Parameters:

zeroed -

Returns:

removePrefixLength

@Deprecated
public IPv6AddressSegment removePrefixLength()

Deprecated.

Specified by:

removePrefixLength in class IPAddressSegment

Returns:

withoutPrefixLength

public IPv6AddressSegment withoutPrefixLength()

Description copied from class: IPAddressSegment

Returns a segment with the same values but without a prefix length.

Specified by:

withoutPrefixLength in class IPAddressSegment

Returns:

getIterable

public Iterable<IPv6AddressSegment> getIterable()

Description copied from interface: AddressComponentRange

Useful for using an instance in a "for-each loop". Otherwise just call AddressComponentRange.iterator() directly.

Specified by:

getIterable in interface AddressComponentRange

Specified by:

getIterable in interface AddressSegment

Specified by:

getIterable in class IPAddressSegment

Returns:

iterator

public Iterator<IPv6AddressSegment> iterator()

Description copied from interface: AddressComponentRange

Iterates through the individual address components.

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.

Specified by:

iterator in interface AddressComponentRange

Specified by:

iterator in interface AddressSegment

Specified by:

iterator in interface Iterable<IPv6AddressSegment>

Specified by:

iterator in class IPAddressSegment

Returns:

spliterator

public AddressComponentSpliterator<IPv6AddressSegment> spliterator()

Description copied from interface: AddressComponentRange

Partitions and traverses through the individual address components.

Specified by:

spliterator in interface AddressComponent

Specified by:

spliterator in interface AddressComponentRange

Specified by:

spliterator in interface AddressSegment

Specified by:

spliterator in interface Iterable<IPv6AddressSegment>

Specified by:

spliterator in class IPAddressSegment

Returns:

stream

public Stream<IPv6AddressSegment> stream()

Description copied from interface: AddressComponentRange

Returns a sequential stream of the individual address components. For a parallel stream, call BaseStream.parallel() on the returned stream.

Specified by:

stream in interface AddressComponentRange

Specified by:

stream in interface AddressSegment

Specified by:

stream in class IPAddressSegment

Returns:

prefixBlockIterator

public Iterator<IPv6AddressSegment> prefixBlockIterator()

Description copied from class: IPAddressSegment

Iterates through the individual prefix blocks.

If the series has no prefix length, then this is equivalent to IPAddressSegment.iterator()

Specified by:

prefixBlockIterator in class IPAddressSegment

prefixBlockSpliterator

public AddressComponentSpliterator<IPv6AddressSegment> prefixBlockSpliterator()

Description copied from class: IPAddressSegment

Partitions and traverses through the individual prefix blocks of this segment for its prefix length.

Specified by:

prefixBlockSpliterator in class IPAddressSegment

Returns:

prefixBlockStream

public Stream<IPv6AddressSegment> prefixBlockStream()

Description copied from class: IPAddressSegment

Returns a sequential stream of the individual prefix blocks of this segment. For a parallel stream, call BaseStream.parallel() on the returned stream.

Specified by:

prefixBlockStream in class IPAddressSegment

Returns:

prefixBlockIterator

public Iterator<IPv6AddressSegment> prefixBlockIterator(int prefixLength)

Description copied from class: IPAddressSegment

Iterates through the individual prefix blocks according to the given segment prefix length. Any existing prefix length is disregarded.

Specified by:

prefixBlockIterator in class IPAddressSegment

prefixBlockSpliterator

public AddressComponentSpliterator<IPv6AddressSegment> prefixBlockSpliterator(int segPrefLength)

Description copied from class: IPAddressSegment

Partitions and traverses through the individual prefix blocks for the given prefix length.

Specified by:

prefixBlockSpliterator in class IPAddressSegment

Returns:

prefixBlockStream

public Stream<IPv6AddressSegment> prefixBlockStream(int segPrefLength)

Description copied from class: IPAddressSegment

Returns a sequential stream of the individual prefix blocks for the given prefix length. For a parallel stream, call BaseStream.parallel() on the returned stream.

Specified by:

prefixBlockStream in class IPAddressSegment

Returns:

prefixIterator

public Iterator<IPv6AddressSegment> prefixIterator()

Description copied from class: IPAddressSegment

Iterates through the individual prefixes.

If the series has no prefix length, then this is equivalent to IPAddressSegment.iterator()

Specified by:

prefixIterator in class IPAddressSegment

prefixSpliterator

public AddressComponentSpliterator<IPv6AddressSegment> prefixSpliterator()

Description copied from class: IPAddressSegment

Partitions and traverses through the individual prefixes of this segment for its prefix length.

Specified by:

prefixSpliterator in class IPAddressSegment

Returns:

prefixStream

public Stream<IPv6AddressSegment> prefixStream()

Description copied from class: IPAddressSegment

Returns a sequential stream of the individual prefixes of this segment. For a parallel stream, call BaseStream.parallel() on the returned stream.

Specified by:

prefixStream in class IPAddressSegment

Returns:

getBitCount

public int getBitCount()

Description copied from interface: AddressItem

Provides the number of bits comprising this address item

Specified by:

getBitCount in interface AddressItem

Specified by:

getBitCount in interface IPAddressStringDivision

Returns:

the number of bits

getByteCount

public int getByteCount()

Description copied from interface: AddressItem

Provides the number of bytes required for this address item, rounding up if the bit count is not a multiple of 8

Specified by:

getByteCount in interface AddressItem

Returns:

the number of bytes

getDefaultTextualRadix

public int getDefaultTextualRadix()

getMaxDigitCount

public int getMaxDigitCount()

getSplitSegments

public <S extends AddressSegment> void getSplitSegments(S[] segs,
 int index,
 AddressNetwork.AddressSegmentCreator<S> creator)

Converts this IPv6 address segment into smaller segments, copying them into the given array starting at the given index. If a segment does not fit into the array because the segment index in the array is out of bounds of the array, then it is not copied.

Parameters:

segs -

index -

prefixContains

public boolean prefixContains(IPAddressSegment other,
 int segmentPrefixLength)

Description copied from class: IPAddressSegment

Returns whether the given prefix bit value ranges contain the same bits of the given segment.

Overrides:

prefixContains in class IPAddressSegment

Parameters:

other -

segmentPrefixLength -

Returns:

prefixEquals

public boolean prefixEquals(AddressSegment other,
 int segmentPrefixLength)

Description copied from interface: AddressSegment

Returns whether the given prefix bits match the same bits of the given segment.

Specified by:

prefixEquals in interface AddressSegment

Overrides:

prefixEquals in class IPAddressSegment

Parameters:

other -

segmentPrefixLength -

Returns:

overlaps

public boolean overlaps(AddressSegment other)

Specified by:

overlaps in interface AddressSegment

contains

public boolean contains(AddressSegment other)

Specified by:

contains in interface AddressSegment

equals

public boolean equals(Object other)

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.

Specified by:

equals in interface AddressSegment

Overrides:

equals in class AddressDivision