inet.ipaddr.ipv4

Class IPv4AddressSection

java.lang.Object

inet.ipaddr.format.AddressDivisionGrouping

inet.ipaddr.format.IPAddressDivisionGrouping

inet.ipaddr.IPAddressSection

inet.ipaddr.ipv4.IPv4AddressSection

All Implemented Interfaces:

AddressComponent, AddressSection, AddressSegmentSeries, AddressDivisionSeries, AddressItem, AddressStringDivisionSeries, IPAddressStringDivisionSeries, java.io.Serializable, java.lang.Comparable<AddressDivisionGrouping>, java.lang.Iterable<IPv4AddressSection>

public class IPv4AddressSection
extends IPAddressSection
implements java.lang.Iterable<IPv4AddressSection>

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	IPv4AddressSection.IPv4StringBuilderOptions
static class	IPv4AddressSection.IPv4StringOptions Represents a clear way to create a specific type of string.

Nested classes/interfaces inherited from class inet.ipaddr.IPAddressSection

IPAddressSection.IPStringBuilderOptions, IPAddressSection.IPStringOptions, IPAddressSection.SegFunction<R,S>, IPAddressSection.WildcardOptions

Nested classes/interfaces inherited from class inet.ipaddr.format.IPAddressDivisionGrouping

IPAddressDivisionGrouping.Range, IPAddressDivisionGrouping.RangeList

Nested classes/interfaces inherited from class inet.ipaddr.format.AddressDivisionGrouping

AddressDivisionGrouping.StringOptions

Constructor Summary

Constructors

Constructor and Description
IPv4AddressSection(Address.SegmentValueProvider lowerValueProvider, Address.SegmentValueProvider upperValueProvider)
IPv4AddressSection(Address.SegmentValueProvider lowerValueProvider, Address.SegmentValueProvider upperValueProvider, java.lang.Integer prefix)
IPv4AddressSection(byte[] bytes)
IPv4AddressSection(byte[] bytes, java.lang.Integer prefix)
IPv4AddressSection(int value)
IPv4AddressSection(int value, java.lang.Integer prefix)
IPv4AddressSection(IPv4AddressSegment segment) Constructs a single segment section.
IPv4AddressSection(IPv4AddressSegment[] segments)
IPv4AddressSection(IPv4AddressSegment[] segments, java.lang.Integer networkPrefixLength)

Method Summary

Modifier and Type	Method and Description
IPv4AddressSection	adjustPrefixBySegment(boolean nextSegment) Increases or decreases prefix length to the next segment boundary.
IPv4AddressSection	adjustPrefixLength(int adjustment) Increases or decreases prefix length by the given increment.
IPv4AddressSection	append(IPv4AddressSection other)
IPv4AddressSection	applyPrefixLength(int networkPrefixLength) Applies the given network prefix bit length.
IPv4AddressSection	bitwiseOr(IPv4AddressSection mask) Does the bitwise disjunction with this address.
IPv4AddressSection	bitwiseOrNetwork(IPv4AddressSection mask, int networkPrefixLength) Does the bitwise disjunction with this address.
boolean	contains(AddressSection other) Determines if one section contains another.
boolean	equals(java.lang.Object o)
int	getBitsPerSegment()
int	getByteIndex(int networkPrefixLength)
int	getBytesPerSegment()
IPv4AddressSection	getHostSection(int networkPrefixLength)
IPAddress.IPVersion	getIPVersion()
java.lang.Iterable<IPv4AddressSection>	getIterable() Useful for using an instance in a "for-each loop".
IPv4AddressSection	getLower() If this represents an address section with ranging values, returns an address section representing the lower values of the range If this represents an address section with a single value in each segment, returns this.
IPv4AddressNetwork	getNetwork()
IPv4AddressSection	getNetworkSection(int networkPrefixLength)
IPv4AddressSection	getNetworkSection(int networkPrefixLength, boolean withPrefixLength)
IPAddressStringDivisionSeries[]	getParts(IPAddressSection.IPStringBuilderOptions options) Get all representations of this address including this IPAddressSection.
IPAddressStringDivisionSeries[]	getParts(IPv4AddressSection.IPv4StringBuilderOptions options)
IPv4AddressSection	getSection(int index) Gets the subsection from the series starting from the given index
IPv4AddressSection	getSection(int index, int endIndex) Gets the subsection from the series starting from the given index and ending just before the give endIndex
IPv4AddressSegment	getSegment(int index)
int	getSegmentIndex(int networkPrefixLength)
IPv4AddressSegment[]	getSegments()
void	getSegments(java.util.Collection<? super IPv4AddressSegment> segs)
void	getSegments(int start, int end, java.util.Collection<? super IPv4AddressSegment> segs)
IPv4AddressSection	getUpper() If this represents an address section with ranging values, returns an address section representing the upper values of the range If this represents an address section with a single value in each segment, returns this.
boolean	isIPv4()
java.util.Iterator<IPv4AddressSection>	iterator() An address component can represent a single segment, address, or section, or it can represent multiple, typically a subnet or range of segment, address, or section values.
IPv4AddressSection	mask(IPv4AddressSection mask)
IPv4AddressSection	maskNetwork(IPv4AddressSection mask, int networkPrefixLength) Applies the given mask to the network section of the address as indicated by the given prefix length.
IPv4AddressSection	prepend(IPv4AddressSection other)
IPv4AddressSection	removePrefixLength() Removes the prefix.
IPv4AddressSection	removePrefixLength(boolean zeroed)
IPv4AddressSection	replace(IPv4AddressSection other, int index)
IPv4AddressSection	reverseBits(boolean perByte) Returns a new segment series with the bits reversed.
IPv4AddressSection	reverseBytes() Returns a new segment series with the bytes reversed.
IPv4AddressSection	reverseBytesPerSegment() Returns a new segment series with the bytes reversed within each segment.
IPv4AddressSection	reverseSegments() Returns a new segment series with the segments reversed.
java.util.Iterator<IPv4AddressSegment[]>	segmentsIterator()
IPv4AddressSection	setPrefixLength(int networkPrefixLength) Sets the prefix length.
IPv4AddressSection	setPrefixLength(int networkPrefixLength, boolean withZeros)
IPv4AddressSection[]	subtract(IPv4AddressSection other) Subtract the give subnet from this subnet, returning an array of sections for the result (the subnets will not be contiguous so an array is required).
IPAddressPartStringCollection	toAllStringCollection() Use this method with care...
java.lang.String	toCanonicalString() This produces a canonical string.
java.lang.String	toCanonicalWildcardString() This produces a string similar to the canonical string and avoids the CIDR prefix.
java.lang.String	toCompressedString() The shortest string for IPv4 addresses is the same as the canonical string.
java.lang.String	toCompressedWildcardString() This is similar to toNormalizedWildcardString, avoiding the CIDR prefix, but with compression as well.
IPAddressPartStringCollection	toDatabaseSearchStringCollection() Returns a set of strings for search the standard string representations in a database -compress the largest compressible segments or no compression (a:0:0:c:d:0:e:f or a::c:d:0:e:f) -upper/lowercase is not considered because many databases are case-insensitive
java.lang.String	toFullString() This produces a string with no compressed segments and all segments of full length, which is 3 characters for IPv4 segments.
java.lang.String	toInetAtonString(IPv4Address.inet_aton_radix radix)
java.lang.String	toInetAtonString(IPv4Address.inet_aton_radix radix, int joinedCount)
IPAddressDivisionGrouping	toJoinedSegments(int joinCount)
java.lang.String	toNormalizedString() The normalized string returned by this method is consistent with java.net.Inet4Address, and is the same as the canonical string.
java.lang.String	toNormalizedString(IPAddressSection.IPStringOptions stringParams, int joinCount)
java.lang.String	toNormalizedWildcardString() This produces a string similar to the normalized string and avoids the CIDR prefix.
java.lang.String	toPrefixLengthString() Returns a string with a CIDR prefix length if this section has a network prefix length.
java.lang.String	toReverseDNSLookupString() Generates the reverse DNS lookup string For 8.255.4.4 it is 4.4.255.8.in-addr.arpa For 2001:db8::567:89ab it is b.a.9.8.7.6.5.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.b.d.0.1.0.0.2.ip6.arpa
java.lang.String	toSQLWildcardString() This is the same as the string from toNormalizedWildcardString except that: -it uses IPAddress.SEGMENT_SQL_WILDCARD instead of IPAddress.SEGMENT_WILDCARD -it uses IPAddress.SEGMENT_SQL_SINGLE_WILDCARD
IPAddressPartStringCollection	toStandardStringCollection() Returns at most a couple dozen string representations: -mixed (1:2:3:4:5:6:1.2.3.4) -upper and lower case -full compressions or no compression (a:0:0:c:d:0:e:f or a::c:d:0:e:f or a:0:b:c:d::e:f) -full leading zeros (000a:0000:000b:000c:000d:0000:000e:000f) -combinations thereof
IPAddressPartStringCollection	toStringCollection(IPAddressSection.IPStringBuilderOptions opts)
IPAddressPartStringCollection	toStringCollection(IPv4AddressSection.IPv4StringBuilderOptions opts)
java.lang.String	toSubnetString() Produces a consistent subnet string.

Methods inherited from class inet.ipaddr.IPAddressSection

bitsPerSegment, bytesPerSegment, contains, getBitCount, getByteCount, getEquivalentPrefix, getHostBits, getMaskPrefixLength, getMinPrefix, getSegmentCount, getSegmentPrefixLength, getSegmentPrefixLength, getSegments, getSegments, getSegmentStrings, getStartsWithSQLClause, getStartsWithSQLClause, isEntireAddress, isFullRange, isIPv6, isMaskCompatibleWithRange, toBinaryString, toHexString, toMinPrefixedEquivalent, toNormalizedString, toNormalizedString, toOctalString, toPrefixedEquivalent, toString

Methods inherited from class inet.ipaddr.format.IPAddressDivisionGrouping

getDivision, getNetworkPrefixLength, getPrefixLength, getZeroRangeSegments, getZeroSegments, isMore, isMultipleByNetworkPrefix, isMultipleByPrefix, isPrefixed, isRangeEquivalentToPrefix

Methods inherited from class inet.ipaddr.format.AddressDivisionGrouping

compareTo, getBytes, getBytes, getCount, getDivisionCount, getUpperBytes, getUpperBytes, hashCode, isMultiple, isRangeEquivalent, isZero

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.AddressDivisionSeries

getDivision, getPrefixLength, isMore, isMultipleByPrefix, isPrefixed, isRangeEquivalentToPrefix

Methods inherited from interface inet.ipaddr.format.AddressStringDivisionSeries

getDivisionCount

Methods inherited from interface inet.ipaddr.format.AddressItem

getBytes, getBytes, getCount, getUpperBytes, getUpperBytes, isMultiple, isZero

Constructor Detail

IPv4AddressSection

public IPv4AddressSection(IPv4AddressSegment[] segments,
                          java.lang.Integer networkPrefixLength)

Parameters:

segments - an array containing the segments. Segments that are entirely part of the host section need not be provided, although the array must be the correct length.

networkPrefixLength -

IPv4AddressSection

public IPv4AddressSection(IPv4AddressSegment[] segments)

IPv4AddressSection

public IPv4AddressSection(IPv4AddressSegment segment)

Constructs a single segment section.

Parameters:

segment -

IPv4AddressSection

public IPv4AddressSection(Address.SegmentValueProvider lowerValueProvider,
                          Address.SegmentValueProvider upperValueProvider,
                          java.lang.Integer prefix)

IPv4AddressSection

public IPv4AddressSection(Address.SegmentValueProvider lowerValueProvider,
                          Address.SegmentValueProvider upperValueProvider)

IPv4AddressSection

public IPv4AddressSection(int value,
                          java.lang.Integer prefix)

IPv4AddressSection

public IPv4AddressSection(int value)

IPv4AddressSection

public IPv4AddressSection(byte[] bytes,
                          java.lang.Integer prefix)

IPv4AddressSection

public IPv4AddressSection(byte[] bytes)

Method Detail

getSegments

public IPv4AddressSegment[] getSegments()

Specified by:

getSegments in interface AddressSegmentSeries

Specified by:

getSegments in class IPAddressSection

Returns:

an array containing the segments

getSection

public IPv4AddressSection getSection(int index)

Description copied from interface: AddressSegmentSeries

Gets the subsection from the series starting from the given index

Specified by:

getSection in interface AddressSection

Specified by:

getSection in interface AddressSegmentSeries

Specified by:

getSection in class IPAddressSection

Returns:

getSection

public IPv4AddressSection getSection(int index,
                                     int endIndex)

Description copied from interface: AddressSegmentSeries

Gets the subsection from the series starting from the given index and ending just before the give endIndex

Specified by:

getSection in interface AddressSection

Specified by:

getSection in interface AddressSegmentSeries

Specified by:

getSection in class IPAddressSection

Returns:

getLower

public IPv4AddressSection getLower()

Description copied from class: IPAddressSection

If this represents an address section with ranging values, returns an address section representing the lower values of the range If this represents an address section with a single value in each segment, returns this.

Specified by:

getLower in interface AddressComponent

Specified by:

getLower in interface AddressSection

Specified by:

getLower in interface AddressSegmentSeries

Specified by:

getLower in class IPAddressSection

Returns:

getUpper

public IPv4AddressSection getUpper()

Description copied from class: IPAddressSection

If this represents an address section with ranging values, returns an address section representing the upper values of the range If this represents an address section with a single value in each segment, returns this.

Specified by:

getUpper in interface AddressComponent

Specified by:

getUpper in interface AddressSection

Specified by:

getUpper in interface AddressSegmentSeries

Specified by:

getUpper in class IPAddressSection

Returns:

reverseBits

public IPv4AddressSection reverseBits(boolean perByte)

Description copied from interface: AddressSegmentSeries

Returns a new segment series with the bits reversed.

Specified by:

reverseBits in interface AddressComponent

Specified by:

reverseBits in interface AddressSection

Specified by:

reverseBits in interface AddressSegmentSeries

Specified by:

reverseBits in class IPAddressSection

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 IPv4AddressSection reverseBytes()

Description copied from interface: AddressSegmentSeries

Returns a new segment series with the bytes reversed.

Specified by:

reverseBytes in interface AddressComponent

Specified by:

reverseBytes in interface AddressSection

Specified by:

reverseBytes in interface AddressSegmentSeries

Specified by:

reverseBytes in class IPAddressSection

Returns:

reverseBytesPerSegment

public IPv4AddressSection reverseBytesPerSegment()

Description copied from interface: AddressSegmentSeries

Returns a new segment series with the bytes reversed within each segment.

Specified by:

reverseBytesPerSegment in interface AddressSection

Specified by:

reverseBytesPerSegment in interface AddressSegmentSeries

Specified by:

reverseBytesPerSegment in class IPAddressSection

Returns:

reverseSegments

public IPv4AddressSection reverseSegments()

Description copied from interface: AddressSegmentSeries

Returns a new segment series with the segments reversed. This does not throw AddressTypeException.

Specified by:

reverseSegments in interface AddressSection

Specified by:

reverseSegments in interface AddressSegmentSeries

Specified by:

reverseSegments in class IPAddressSection

Returns:

getIterable

public java.lang.Iterable<IPv4AddressSection> getIterable()

Description copied from interface: AddressComponent

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

Specified by:

getIterable in interface AddressComponent

Specified by:

getIterable in interface AddressSection

Specified by:

getIterable in interface AddressSegmentSeries

Specified by:

getIterable in class IPAddressSection

Returns:

iterator

public java.util.Iterator<IPv4AddressSection> iterator()

Description copied from interface: AddressComponent

An address component can represent a single segment, address, or section, or it can represent multiple, typically a subnet or range of segment, address, or section values. Call AddressItem.isMultiple() to determine if this instance represents multiple. This method iterates through the individual elements.

Specified by:

iterator in interface AddressComponent

Specified by:

iterator in interface AddressSection

Specified by:

iterator in interface AddressSegmentSeries

Specified by:

iterator in interface java.lang.Iterable<IPv4AddressSection>

Specified by:

iterator in class IPAddressSection

Returns:

segmentsIterator

public java.util.Iterator<IPv4AddressSegment[]> segmentsIterator()

Specified by:

segmentsIterator in interface AddressSegmentSeries

Specified by:

segmentsIterator in class IPAddressSection

getSegment

public IPv4AddressSegment getSegment(int index)

Specified by:

getSegment in interface AddressSegmentSeries

Overrides:

getSegment in class IPAddressSection

getSegments

public void getSegments(java.util.Collection<? super IPv4AddressSegment> segs)

getSegments

public void getSegments(int start,
                        int end,
                        java.util.Collection<? super IPv4AddressSegment> segs)

getBitsPerSegment

public int getBitsPerSegment()

Specified by:

getBitsPerSegment in interface AddressSegmentSeries

getBytesPerSegment

public int getBytesPerSegment()

Specified by:

getBytesPerSegment in interface AddressSegmentSeries

isIPv4

public boolean isIPv4()

Overrides:

isIPv4 in class IPAddressSection

getIPVersion

public IPAddress.IPVersion getIPVersion()

Specified by:

getIPVersion in class IPAddressSection

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class IPAddressDivisionGrouping

replace

public IPv4AddressSection replace(IPv4AddressSection other,
                                  int index)

prepend

public IPv4AddressSection prepend(IPv4AddressSection other)

append

public IPv4AddressSection append(IPv4AddressSection other)

contains

public boolean contains(AddressSection other)

Description copied from interface: AddressSection

Determines if one section contains another. Sections must have the same number of segments to be comparable. For sections which are aware of their position in an address (IPv6 and MAC), their respective positions must match to be comparable.

Specified by:

contains in interface AddressSection

Returns:

whether this section contains the given address section

subtract

public IPv4AddressSection[] subtract(IPv4AddressSection other)

Subtract the give subnet from this subnet, returning an array of sections for the result (the subnets will not be contiguous so an array is required). Computes the subnet difference, the set of addresses in this address section but not in the provided section. Keep in mind this is set subtraction, not subtraction of segment values. We have a subnet of addresses and we are removing some of those addresses.

Parameters:

other -

Returns:

the difference

Throws:

AddressTypeException - if the two sections are not comparable

getByteIndex

public int getByteIndex(int networkPrefixLength)

Specified by:

getByteIndex in class IPAddressSection

getSegmentIndex

public int getSegmentIndex(int networkPrefixLength)

Specified by:

getSegmentIndex in class IPAddressSection

getNetwork

public IPv4AddressNetwork getNetwork()

Specified by:

getNetwork in class IPAddressSection

adjustPrefixBySegment

public IPv4AddressSection adjustPrefixBySegment(boolean nextSegment)

Description copied from interface: AddressSegmentSeries

Increases or decreases prefix length to the next segment boundary. When prefix length is increased, the bits moved within the prefix are zero.

Specified by:

adjustPrefixBySegment in interface AddressSection

Specified by:

adjustPrefixBySegment in interface AddressSegmentSeries

Overrides:

adjustPrefixBySegment in class IPAddressSection

Returns:

adjustPrefixLength

public IPv4AddressSection adjustPrefixLength(int adjustment)

Description copied from interface: AddressSegmentSeries

Increases or decreases prefix length by the given increment. When prefix length is increased, the bits moved within the prefix become zero. When the prefix is extended beyond the segment series boundary, it is removed.

Specified by:

adjustPrefixLength in interface AddressSection

Specified by:

adjustPrefixLength in interface AddressSegmentSeries

Specified by:

adjustPrefixLength in class IPAddressSection

Returns:

applyPrefixLength

public IPv4AddressSection applyPrefixLength(int networkPrefixLength)

Description copied from class: IPAddressSection

Applies the given network prefix bit length.

Specified by:

applyPrefixLength in interface AddressSection

Specified by:

applyPrefixLength in interface AddressSegmentSeries

Specified by:

applyPrefixLength in class IPAddressSection

setPrefixLength

public IPv4AddressSection setPrefixLength(int networkPrefixLength)

Description copied from interface: AddressSegmentSeries

Sets the prefix length. When the series already had a prefix, and the prefix length is increased, the bits moved within the prefix are zero. When the prefix is extended beyond the segment series boundary, it is removed.

Specified by:

setPrefixLength in interface AddressSection

Specified by:

setPrefixLength in interface AddressSegmentSeries

Specified by:

setPrefixLength in class IPAddressSection

Returns:

setPrefixLength

public IPv4AddressSection setPrefixLength(int networkPrefixLength,
                                          boolean withZeros)

Specified by:

setPrefixLength in class IPAddressSection

bitwiseOrNetwork

public IPv4AddressSection bitwiseOrNetwork(IPv4AddressSection mask,
                                           int networkPrefixLength)
                                    throws AddressTypeException

Does the bitwise disjunction with this address. Useful when subnetting. Any existing prefix length is dropped for the new prefix length and the mask is applied up to the end the new prefix length.

Parameters:

mask -

Returns:

Throws:

AddressTypeException

bitwiseOr

public IPv4AddressSection bitwiseOr(IPv4AddressSection mask)
                             throws AddressTypeException

Does the bitwise disjunction with this address. Useful when subnetting.

Parameters:

mask -

Returns:

Throws:

AddressTypeException

removePrefixLength

public IPv4AddressSection removePrefixLength()

Description copied from interface: AddressSegmentSeries

Removes the prefix. When the series already had a prefix, the bits previously not within the prefix are zero.

Specified by:

removePrefixLength in interface AddressSection

Specified by:

removePrefixLength in interface AddressSegmentSeries

Specified by:

removePrefixLength in class IPAddressSection

Returns:

removePrefixLength

public IPv4AddressSection removePrefixLength(boolean zeroed)

Specified by:

removePrefixLength in class IPAddressSection

mask

public IPv4AddressSection mask(IPv4AddressSection mask)
                        throws AddressTypeException

Throws:

AddressTypeException

maskNetwork

public IPv4AddressSection maskNetwork(IPv4AddressSection mask,
                                      int networkPrefixLength)
                               throws AddressTypeException

Applies the given mask to the network section of the address as indicated by the given prefix length. Useful for subnetting. Once you have zeroed a section of the network you can insert bits using bitwiseOr(IPv4AddressSection) or replace(IPv4AddressSection, int)

Parameters:

mask -

networkPrefixLength -

Returns:

Throws:

AddressTypeException

getNetworkSection

public IPv4AddressSection getNetworkSection(int networkPrefixLength)

Specified by:

getNetworkSection in class IPAddressSection

getNetworkSection

public IPv4AddressSection getNetworkSection(int networkPrefixLength,
                                            boolean withPrefixLength)

Specified by:

getNetworkSection in class IPAddressSection

getHostSection

public IPv4AddressSection getHostSection(int networkPrefixLength)

Specified by:

getHostSection in class IPAddressSection

toCanonicalString

public java.lang.String toCanonicalString()

This produces a canonical string.

Specified by:

toCanonicalString in interface AddressSegmentSeries

Returns:

toFullString

public java.lang.String toFullString()

This produces a string with no compressed segments and all segments of full length, which is 3 characters for IPv4 segments.

Specified by:

toFullString in class IPAddressSection

toCompressedString

public java.lang.String toCompressedString()

The shortest string for IPv4 addresses is the same as the canonical string.

Specified by:

toCompressedString in interface AddressSegmentSeries

Specified by:

toCompressedString in class IPAddressSection

Returns:

toNormalizedString

public java.lang.String toNormalizedString()

The normalized string returned by this method is consistent with java.net.Inet4Address, and is the same as the canonical string.

Specified by:

toNormalizedString in interface AddressComponent

Returns:

toCompressedWildcardString

public java.lang.String toCompressedWildcardString()

Description copied from class: IPAddressSection

This is similar to toNormalizedWildcardString, avoiding the CIDR prefix, but with compression as well.

Specified by:

toCompressedWildcardString in class IPAddressSection

toSubnetString

public java.lang.String toSubnetString()

Description copied from class: IPAddressSection

Produces a consistent subnet string. In the case of IPv4, this means that wildcards are used instead of a network prefix. In the case of IPv6, a prefix will be used and the host section will be compressed with ::.

Specified by:

toSubnetString in class IPAddressSection

toPrefixLengthString

public java.lang.String toPrefixLengthString()

Description copied from class: IPAddressSection

Returns a string with a CIDR prefix length if this section has a network prefix length. For IPv6, the host section will be compressed with ::, for IPv4 the host section will be zeros.

Specified by:

toPrefixLengthString in class IPAddressSection

Returns:

toInetAtonString

public java.lang.String toInetAtonString(IPv4Address.inet_aton_radix radix)

toInetAtonString

public java.lang.String toInetAtonString(IPv4Address.inet_aton_radix radix,
                                         int joinedCount)

toNormalizedWildcardString

public java.lang.String toNormalizedWildcardString()

Description copied from class: IPAddressSection

This produces a string similar to the normalized string and avoids the CIDR prefix. CIDR addresses will be shown with wildcards and ranges instead of using the CIDR prefix notation.

Specified by:

toNormalizedWildcardString in class IPAddressSection

toCanonicalWildcardString

public java.lang.String toCanonicalWildcardString()

Description copied from class: IPAddressSection

This produces a string similar to the canonical string and avoids the CIDR prefix. Addresses with a network prefix length will be shown with wildcards and ranges instead of using the CIDR prefix length notation. IPv6 addresses will be compressed according to the canonical representation.

Specified by:

toCanonicalWildcardString in class IPAddressSection

toSQLWildcardString

public java.lang.String toSQLWildcardString()

Description copied from class: IPAddressSection

This is the same as the string from toNormalizedWildcardString except that: -it uses IPAddress.SEGMENT_SQL_WILDCARD instead of IPAddress.SEGMENT_WILDCARD -it uses IPAddress.SEGMENT_SQL_SINGLE_WILDCARD

Specified by:

toSQLWildcardString in class IPAddressSection

toReverseDNSLookupString

public java.lang.String toReverseDNSLookupString()

Description copied from class: IPAddressSection

Generates the reverse DNS lookup string For 8.255.4.4 it is 4.4.255.8.in-addr.arpa For 2001:db8::567:89ab it is b.a.9.8.7.6.5.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.b.d.0.1.0.0.2.ip6.arpa

Specified by:

toReverseDNSLookupString in class IPAddressSection

Returns:

toNormalizedString

public java.lang.String toNormalizedString(IPAddressSection.IPStringOptions stringParams,
                                           int joinCount)

toJoinedSegments

public IPAddressDivisionGrouping toJoinedSegments(int joinCount)

toAllStringCollection

public IPAddressPartStringCollection toAllStringCollection()

Description copied from class: IPAddressSection

Use this method with care... a single IPv6 address can have thousands of string representations. Examples: "::" has 1297 such variations, but only 9 are considered standard "a:b:c:0:d:e:f:1" has 1920 variations, but only 12 are standard Variations included in this method: -all standard variations -choosing specific segments for full leading zeros (::a:b can be ::000a:b, ::a:000b, or ::000a:000b) -choosing which zero-segments to compress (0:0:a:: can be ::a:0:0:0:0:0 or 0:0:a::) -mixed representation (1:2:3:4:5:6:1.2.3.4) -all combinations of such variations Variations omitted from this method: -mixed case of a-f, which you can easily handle yourself with String.equalsIgnoreCase -adding a variable number of leading zeros (::a can be ::0a, ::00a, ::000a) -choosing any number of zero-segments anywhere to compress (:: can be 0:0:0::0:0)

Overrides:

toAllStringCollection in class IPAddressSection

Returns:

toStandardStringCollection

public IPAddressPartStringCollection toStandardStringCollection()

Description copied from class: IPAddressSection

Returns at most a couple dozen string representations: -mixed (1:2:3:4:5:6:1.2.3.4) -upper and lower case -full compressions or no compression (a:0:0:c:d:0:e:f or a::c:d:0:e:f or a:0:b:c:d::e:f) -full leading zeros (000a:0000:000b:000c:000d:0000:000e:000f) -combinations thereof

Overrides:

toStandardStringCollection in class IPAddressSection

Returns:

toDatabaseSearchStringCollection

public IPAddressPartStringCollection toDatabaseSearchStringCollection()

Description copied from class: IPAddressSection

Returns a set of strings for search the standard string representations in a database -compress the largest compressible segments or no compression (a:0:0:c:d:0:e:f or a::c:d:0:e:f) -upper/lowercase is not considered because many databases are case-insensitive

Overrides:

toDatabaseSearchStringCollection in class IPAddressSection

Returns:

toStringCollection

public IPAddressPartStringCollection toStringCollection(IPAddressSection.IPStringBuilderOptions opts)

Specified by:

toStringCollection in class IPAddressSection

toStringCollection

public IPAddressPartStringCollection toStringCollection(IPv4AddressSection.IPv4StringBuilderOptions opts)

getParts

public IPAddressStringDivisionSeries[] getParts(IPAddressSection.IPStringBuilderOptions options)

Description copied from class: IPAddressSection

Get all representations of this address including this IPAddressSection. This includes:

• alternative segment groupings expressed as IPAddressDivisionGrouping
• conversions to IPv6, and alternative representations of those IPv6 addresses

Overrides:

getParts in class IPAddressSection

Returns:

getParts

public IPAddressStringDivisionSeries[] getParts(IPv4AddressSection.IPv4StringBuilderOptions options)