IPv4AddressSection (IPAddress javadoc by seancfoley)

java.lang.Object
- inet.ipaddr.format.AddressDivisionGroupingBase
- - inet.ipaddr.format.standard.AddressDivisionGrouping
  - - inet.ipaddr.format.standard.IPAddressDivisionGrouping
    - - inet.ipaddr.IPAddressSection
      - inet.ipaddr.ipv4.IPv4AddressSection

All Implemented Interfaces:

AddressComponent, AddressSection, AddressSegmentSeries, AddressDivisionSeries, AddressItem, AddressItemRange, IPAddressDivisionSeries, inet.ipaddr.format.string.AddressStringDivisionSeries, inet.ipaddr.format.string.IPAddressStringDivisionSeries, IPAddressSegmentSeries, java.io.Serializable, java.lang.Comparable<AddressItem>, 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.SeriesCreator, IPAddressSection.WildcardOptions

Nested classes/interfaces inherited from class inet.ipaddr.format.standard.IPAddressDivisionGrouping
inet.ipaddr.format.standard.IPAddressDivisionGrouping.Range, inet.ipaddr.format.standard.IPAddressDivisionGrouping.RangeList

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

Constructor Summary

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

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`IPv4AddressSection`	`adjustPrefixBySegment(boolean nextSegment)` Increases or decreases prefix length to the next segment boundary.
`IPv4AddressSection`	`adjustPrefixBySegment(boolean nextSegment, boolean zeroed)` Increases or decreases prefix length to the next segment boundary.
`IPv4AddressSection`	`adjustPrefixLength(int adjustment)` Increases or decreases prefix length by the given increment.
`IPv4AddressSection`	`adjustPrefixLength(int adjustment, boolean zeroed)` Increases or decreases prefix length by the given increment.
`IPv4AddressSection`	`append(IPv4AddressSection other)`
`IPv4AddressSection`	`appendToNetwork(IPv4AddressSection other)`
`IPv4AddressSection`	`applyPrefixLength(int networkPrefixLength)` Applies the given prefix length to create a new segment series.
`IPv4AddressSection`	`assignMinPrefixForBlock()` Constructs an equivalent address section with the smallest CIDR prefix possible (largest network), such that the range of values are a set of subnet blocks for that prefix.
`IPv4AddressSection`	`assignPrefixForSingleBlock()` Returns the equivalent CIDR address section with a prefix length for which the subnet block for that prefix matches the range of values in this section.
`IPv4AddressSection`	`bitwiseOr(IPv4AddressSection mask)` Equivalent to `bitwiseOr(IPv4AddressSection, boolean)` with the second argument as false.
`IPv4AddressSection`	`bitwiseOr(IPv4AddressSection mask, boolean retainPrefix)` Does the bitwise disjunction with this address section.
`IPv4AddressSection`	`bitwiseOrNetwork(IPv4AddressSection mask, int networkPrefixLength)` Does the bitwise disjunction with this address section.
`java.util.Iterator<IPv4AddressSection>`	`blockIterator(int segmentCount)` Iterates through series that can be obtained by iterating through all the upper segments up to the given segment count.
`boolean`	`contains(AddressSection other)` Determines if one section contains another.
`IPv4AddressSection`	`createMaxHost()`
`boolean`	`equals(java.lang.Object o)` Two groupings are equal if: - they match type/version (ipv4, ipv6, mac, or a specific grouping class) - they match division counts - each division matches bit counts - each division matches their specific grouping class - each division matches values Prefix lengths, for those groupings and/or divisionsS that have them, are ignored.
`int`	`getBitCount()`
`int`	`getBitsPerSegment()` Returns the number of bits comprising each segment in this series.
`int`	`getByteCount()`
`int`	`getBytesPerSegment()` Returns the number of bytes comprising each segment in this series.
`IPv4AddressSegment`	`getDivision(int index)`
`IPv4AddressSection`	`getHostSection()` Returns the host section of the series.
`IPv4AddressSection`	`getHostSection(int networkPrefixLength)` Returns the host section of the address as indicated by the network prefix length provided.
`long`	`getIPv4Count(boolean excludeZeroHosts)`
`long`	`getIPv4PrefixCount()`
`long`	`getIPv4PrefixCount(int prefixLength)`
`IPAddress.IPVersion`	`getIPVersion()` Returns the version of this segment series
`java.lang.Iterable<IPv4AddressSection>`	`getIterable()` Useful for using an instance in a "for-each loop".
`IPv4AddressSection`	`getLower()` If this represents a series with ranging values, returns a series representing the lower values of the range.
`IPv4AddressSection`	`getLowerNonZeroHost()` Similar to `IPAddressSegmentSeries.getLower()`, but will not return a series that has a prefix length and whose host value is zero.
`IPv4AddressNetwork`	`getNetwork()` Returns the network object for series of the same version (eg IPv4, IPv6 and MAC each have their own network object)
`IPv4AddressSection`	`getNetworkSection()` Returns the network section of the series if the series has a CIDR network prefix length, otherwise it returns the entire series as a prefixed series with prefix matching the address bit length.
`IPv4AddressSection`	`getNetworkSection(int networkPrefixLength)` Returns the network section of the series.
`IPv4AddressSection`	`getNetworkSection(int networkPrefixLength, boolean withPrefixLength)` Returns the network section of the series.
`inet.ipaddr.format.string.IPAddressStringDivisionSeries[]`	`getParts(IPAddressSection.IPStringBuilderOptions options)` Get all representations of this address including this IPAddressSection.
`inet.ipaddr.format.string.IPAddressStringDivisionSeries[]`	`getParts(IPv4AddressSection.IPv4StringBuilderOptions options)`
`java.math.BigInteger`	`getPrefixCount(int prefixLength)` The count of the number of distinct values within the prefix part of the address item, the bits that appear within the prefix length.
`IPv4AddressSection`	`getSection()` Gets the subsection from the series that comprises all segments
`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)` Returns the segment from this series at the given index.
`IPv4AddressSegment[]`	`getSegments()` Returns the segments of this series of segments as an array.
`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 a series with ranging values, returns a series representing the upper values of the range If this represents a series with a single value in each segment, returns this.
`IPv4AddressSection`	`increment(long increment)` Returns the series from the subnet that is the given increment upwards into the subnet range, with the increment of 0 returning the first address in the range.
`IPv4AddressSection`	`incrementBoundary(long increment)` If the given increment is positive, adds the value to the upper series (`AddressSegmentSeries.getUpper()` in the subnet range to produce a new series.
`IPv4AddressSection`	`insert(int index, IPv4AddressSection other)`
`IPv4AddressSection`	`intersect(IPv4AddressSection other)` Produces the subnet sections whose addresses are found in both this and the given argument.
`int`	`intValue()`
`boolean`	`isIPv4()`
`java.util.Iterator<IPv4AddressSection>`	`iterator()` Iterates through the individual segment series.
`long`	`longValue()`
`IPv4AddressSection`	`mask(IPv4AddressSection mask)` Equivalent to `mask(IPv4AddressSection, boolean)` with the second argument as false.
`IPv4AddressSection`	`mask(IPv4AddressSection mask, boolean retainPrefix)` Does the bitwise conjunction with this address.
`IPv4AddressSection`	`maskNetwork(IPv4AddressSection mask, int networkPrefixLength)` Produces the bitwise conjunction of the given mask with the network section of the address as indicated by the given prefix length.
`boolean`	`matchesWithMask(IPAddressSection other, IPAddressSection mask)` Applies the mask to this address section and then compares values with the given address section
`IPv4AddressSection[]`	`mergePrefixBlocks(IPv4AddressSection... sections)` Merges this with the list of sections to produce the smallest array of prefix blocks, going from smallest to largest
`IPv4AddressSection[]`	`mergeToSequentialBlocks(IPv4AddressSection... sections)` Merges this with the list of sections to produce the smallest array of sequential block subnets, going from smallest to largest
`java.util.Iterator<IPv4AddressSection>`	`nonZeroHostIterator()` Similar to the prefix block iterator, but series with a host of zero are skipped.
`java.util.Iterator<IPv4AddressSection>`	`prefixBlockIterator()` Iterates through the individual prefix blocks.
`boolean`	`prefixEquals(AddressSection other)` Determines if the argument section matches this section up to the prefix length of this section.
`java.util.Iterator<IPv4AddressSection>`	`prefixIterator()` Iterates through the individual prefixes.
`IPv4AddressSection`	`removePrefixLength()` Removes the prefix length.
`IPv4AddressSection`	`removePrefixLength(boolean zeroed)` Removes the prefix length.
`IPv4AddressSection`	`replace(int startIndex, int endIndex, IPv4AddressSection replacement, int replacementStartIndex, int replacementEndIndex)` Replaces segments starting from startIndex and ending before endIndex with the segments starting at replacementStartIndex and ending before replacementEndIndex from the replacement section
`IPv4AddressSection`	`replace(int index, IPv4AddressSection other)` Replace the segments of this section starting at the given index with the given replacement segments
`IPv4AddressSection`	`reverseBits(boolean perByte)` Returns a new series which has 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()` Iterates through the individual segments.
`java.util.Iterator<IPv4AddressSegment[]>`	`segmentsNonZeroHostIterator()` Similar to the segments iterator, but series with a host of zero are skipped.
`java.util.Iterator<IPv4AddressSection>`	`sequentialBlockIterator()` Iterates through the sequential series that make up this series.
`IPv4AddressSection`	`setPrefixLength(int networkPrefixLength)` Sets the prefix length.
`IPv4AddressSection`	`setPrefixLength(int networkPrefixLength, boolean withZeros)` Sets the prefix length.
`IPv4AddressSection[]`	`spanWithPrefixBlocks(IPv4AddressSection other)` Produces the list of prefix block subnets that span from this series to the given series.
`IPv4AddressSection[]`	`spanWithRangedSegments(IPv4AddressSection other)` Produces a list of range subnets that span from this series to the given series.
`IPv4AddressSection[]`	`subtract(IPv4AddressSection other)` Subtract the given 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)`
`inet.ipaddr.format.standard.IPAddressDivisionGrouping`	`toJoinedSegments(int joinCount)`
`IPv4AddressSection`	`toMaxHost()` Returns the segment series with a host of all ones.
`IPv4AddressSection`	`toMaxHost(int prefixLength)` Produces the series with host values of all one bits for the given prefix length.
`java.lang.String`	`toNormalizedString()` The normalized string returned by this method is consistent with java.net.Inet4Address, and is the same as `toCanonicalString()`.
`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.
`IPv4AddressSection`	`toPrefixBlock()` If this series has a prefix length, returns the subnet block for that prefix.
`IPv4AddressSection`	`toPrefixBlock(int networkPrefixLength)` Returns the segment series of the same length that spans all hosts.
`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 `Address.SEGMENT_SQL_WILDCARD` instead of `Address.SEGMENT_WILDCARD` and also uses `Address.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.
`IPv4AddressSection`	`toZeroHost()` Returns the segment series with a host of zero.
`IPv4AddressSection`	`toZeroHost(int prefixLength)` Produces the series with host values of 0 for the given prefix length.
`int`	`upperIntValue()`
`long`	`upperLongValue()`
`IPv4AddressSection`	`withoutPrefixLength()` Provides the same address with no prefix.

Methods inherited from class inet.ipaddr.format.standard.IPAddressDivisionGrouping
containsSinglePrefixBlock, getNetworkPrefixLength, getPrefixLength, getZeroRangeSegments, getZeroSegments, isMore, isPrefixBlock, isSinglePrefixBlock

Methods inherited from class inet.ipaddr.format.standard.AddressDivisionGrouping
hashCode

Methods inherited from class inet.ipaddr.format.AddressDivisionGroupingBase
getBytes, getBytes, getBytes, getCount, getDivisionCount, getDivisionStrings, getPrefixCount, getUpperBytes, getUpperBytes, getUpperBytes, getUpperValue, getValue, includesMax, includesZero, isMax, isMultiple, isPrefixed, 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.IPAddressDivisionSeries
getNetworkPrefixLength

Methods inherited from interface inet.ipaddr.format.string.IPAddressStringDivisionSeries
getPrefixLength, isPrefixBlock, isPrefixed

Methods inherited from interface inet.ipaddr.format.AddressDivisionSeries
getCount, getDivisionStrings, getPrefixCount, getPrefixLength, isMore, isPrefixBlock, isPrefixed, isSequential, isSinglePrefixBlock

Methods inherited from interface inet.ipaddr.format.string.AddressStringDivisionSeries
getDivisionCount

- Constructor Detail
  - IPv4AddressSection
```
public IPv4AddressSection(IPv4AddressSegment segment)
```
    Constructs a single segment section.
    
    Parameters:
    
    segment -
  - IPv4AddressSection
```
public IPv4AddressSection(IPv4AddressSegment[] segments)
                   throws AddressValueException
```
    Throws:
    
    AddressValueException
  - IPv4AddressSection
```
public IPv4AddressSection(IPv4AddressSegment[] segments,
                          java.lang.Integer networkPrefixLength)
                   throws AddressValueException
```
    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 -
    
    Throws:
    
    AddressValueException
  - IPv4AddressSection
```
public IPv4AddressSection(Address.SegmentValueProvider valueProvider,
                          int segmentCount,
                          java.lang.Integer networkPrefixLength)
                   throws AddressValueException
```
    Throws:
    
    AddressValueException
  - IPv4AddressSection
```
public IPv4AddressSection(Address.SegmentValueProvider lowerValueProvider,
                          Address.SegmentValueProvider upperValueProvider,
                          int segmentCount,
                          java.lang.Integer networkPrefixLength)
                   throws AddressValueException
```
    Throws:
    
    AddressValueException
  - IPv4AddressSection
```
public IPv4AddressSection(Address.SegmentValueProvider valueProvider,
                          int segmentCount)
                   throws AddressValueException
```
    Throws:
    
    AddressValueException
  - IPv4AddressSection
```
public IPv4AddressSection(Address.SegmentValueProvider lowerValueProvider,
                          Address.SegmentValueProvider upperValueProvider,
                          int segmentCount)
```
  - IPv4AddressSection
```
public IPv4AddressSection(byte[] bytes,
                          java.lang.Integer prefix)
                   throws AddressValueException
```
    Throws:
    
    AddressValueException
  - IPv4AddressSection
```
public IPv4AddressSection(byte[] bytes)
                   throws AddressValueException
```
    Throws:
    
    AddressValueException
  - IPv4AddressSection
```
public IPv4AddressSection(byte[] bytes,
                          int byteStartIndex,
                          int byteEndIndex,
                          java.lang.Integer prefix)
                   throws AddressValueException
```
    Throws:
    
    AddressValueException
  - IPv4AddressSection
```
public IPv4AddressSection(byte[] bytes,
                          int byteStartIndex,
                          int byteEndIndex)
                   throws AddressValueException
```
    Throws:
    
    AddressValueException
  - IPv4AddressSection
```
public IPv4AddressSection(int value,
                          java.lang.Integer networkPrefixLength)
                   throws AddressValueException
```
    Throws:
    
    AddressValueException
  - IPv4AddressSection
```
public IPv4AddressSection(int value)
```
- Method Detail
  - getSegments
```
public IPv4AddressSegment[] getSegments()
```
    Description copied from interface: AddressSegmentSeries
    
    Returns the segments of this series of segments as an array. This must create a new array, so for efficiency use AddressSegmentSeries.getSegment(int) and AddressSegmentSeries.getSegmentCount() instead when feasible.
    
    Specified by:
    
    getSegments in interface AddressSegmentSeries
    
    Specified by:
    
    getSegments in interface IPAddressSegmentSeries
    
    Returns:
  - getSection
```
public IPv4AddressSection getSection()
```
    Description copied from interface: AddressSegmentSeries
    
    Gets the subsection from the series that comprises all segments
    
    Specified by:
    
    getSection in interface AddressSegmentSeries
    
    Specified by:
    
    getSection in interface IPAddressSegmentSeries
    
    Returns:
  - 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 AddressSegmentSeries
    
    Specified by:
    
    getSection in interface IPAddressSegmentSeries
    
    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 AddressSegmentSeries
    
    Specified by:
    
    getSection in interface IPAddressSegmentSeries
    
    Specified by:
    
    getSection in class IPAddressSection
    
    Returns:
  - getLowerNonZeroHost
```
public IPv4AddressSection getLowerNonZeroHost()
```
    Description copied from interface: IPAddressSegmentSeries
    
    Similar to IPAddressSegmentSeries.getLower(), but will not return a series that has a prefix length and whose host value is zero. If this series has no prefix length, returns the same series as IPAddressSegmentSeries.getLower().
    
    Specified by:
    
    getLowerNonZeroHost in interface IPAddressSegmentSeries
    
    Specified by:
    
    getLowerNonZeroHost in class IPAddressSection
    
    Returns:
    
    the lowest IP address series whose host is non-zero, or null if no such address section exists.
  - getLower
```
public IPv4AddressSection getLower()
```
    Description copied from interface: AddressSegmentSeries
    
    If this represents a series with ranging values, returns a series representing the lower values of the range. If this represents an series 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 interface AddressItemRange
    
    Specified by:
    
    getLower in interface IPAddressSegmentSeries
    
    Specified by:
    
    getLower in class IPAddressSection
    
    Returns:
  - getUpper
```
public IPv4AddressSection getUpper()
```
    Description copied from interface: AddressSegmentSeries
    
    If this represents a series with ranging values, returns a series representing the upper values of the range If this represents a series 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 interface AddressItemRange
    
    Specified by:
    
    getUpper in interface IPAddressSegmentSeries
    
    Specified by:
    
    getUpper in class IPAddressSection
    
    Returns:
  - intValue
```
public int intValue()
```
  - upperIntValue
```
public int upperIntValue()
```
  - longValue
```
public long longValue()
```
  - upperLongValue
```
public long upperLongValue()
```
  - reverseBits
```
public IPv4AddressSection reverseBits(boolean perByte)
```
    Description copied from interface: IPAddressSegmentSeries
    
    Returns a new series which has the bits reversed.
    If this has an associated prefix length, then the prefix length is dropped in the reversed series.
    If this represents a range of values that cannot be reversed, because reversing the range results in a set of addresses that cannot be described by a range, then this throws IncompatibleAddressException. In such cases you can call IPAddressSegmentSeries.iterator(), IPAddressSegmentSeries.getLower(), IPAddressSegmentSeries.getUpper() or some other method to transform the address into an address representing a single value before reversing.
    
    Specified by:
    
    reverseBits in interface AddressComponent
    
    Specified by:
    
    reverseBits in interface AddressSection
    
    Specified by:
    
    reverseBits in interface AddressSegmentSeries
    
    Specified by:
    
    reverseBits in interface IPAddressSegmentSeries
    
    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 address 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 interface IPAddressSegmentSeries
    
    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 interface IPAddressSegmentSeries
    
    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 IncompatibleAddressException since all address series can reverse their segments.
    
    Specified by:
    
    reverseSegments in interface AddressSection
    
    Specified by:
    
    reverseSegments in interface AddressSegmentSeries
    
    Specified by:
    
    reverseSegments in interface IPAddressSegmentSeries
    
    Specified by:
    
    reverseSegments in class IPAddressSection
    
    Returns:
  - getIterable
```
public java.lang.Iterable<IPv4AddressSection> getIterable()
```
    Description copied from interface: AddressItemRange
    
    Useful for using an instance in a "for-each loop". Otherwise just call AddressItemRange.iterator() directly.
    
    Specified by:
    
    getIterable in interface AddressComponent
    
    Specified by:
    
    getIterable in interface AddressSection
    
    Specified by:
    
    getIterable in interface AddressSegmentSeries
    
    Specified by:
    
    getIterable in interface AddressItemRange
    
    Specified by:
    
    getIterable in interface IPAddressSegmentSeries
    
    Specified by:
    
    getIterable in class IPAddressSection
    
    Returns:
  - nonZeroHostIterator
```
public java.util.Iterator<IPv4AddressSection> nonZeroHostIterator()
```
    Description copied from interface: IPAddressSegmentSeries
    
    Similar to the prefix block iterator, but series with a host of zero are skipped.
    
    Specified by:
    
    nonZeroHostIterator in interface IPAddressSegmentSeries
    
    Specified by:
    
    nonZeroHostIterator in class IPAddressSection
    
    Returns:
  - iterator
```
public java.util.Iterator<IPv4AddressSection> iterator()
```
    Description copied from interface: AddressSegmentSeries
    
    Iterates through the individual segment series. The resulting elements will not have an assigned prefix.
    
    Specified by:
    
    iterator in interface AddressComponent
    
    Specified by:
    
    iterator in interface AddressSection
    
    Specified by:
    
    iterator in interface AddressSegmentSeries
    
    Specified by:
    
    iterator in interface AddressItemRange
    
    Specified by:
    
    iterator in interface IPAddressSegmentSeries
    
    Specified by:
    
    iterator in interface java.lang.Iterable<IPv4AddressSection>
    
    Specified by:
    
    iterator in class IPAddressSection
    
    Returns:
  - prefixIterator
```
public java.util.Iterator<IPv4AddressSection> prefixIterator()
```
    Description copied from interface: AddressSegmentSeries
    
    Iterates through the individual prefixes. If the series has no prefix length, then this is equivalent to AddressSegmentSeries.iterator()
    
    Specified by:
    
    prefixIterator in interface AddressSection
    
    Specified by:
    
    prefixIterator in interface AddressSegmentSeries
    
    Specified by:
    
    prefixIterator in interface IPAddressSegmentSeries
    
    Specified by:
    
    prefixIterator in class IPAddressSection
  - prefixBlockIterator
```
public java.util.Iterator<IPv4AddressSection> prefixBlockIterator()
```
    Description copied from interface: AddressSegmentSeries
    
    Iterates through the individual prefix blocks. If the series has no prefix length, then this is equivalent to AddressSegmentSeries.iterator()
    
    Specified by:
    
    prefixBlockIterator in interface AddressSection
    
    Specified by:
    
    prefixBlockIterator in interface AddressSegmentSeries
    
    Specified by:
    
    prefixBlockIterator in interface IPAddressSegmentSeries
    
    Specified by:
    
    prefixBlockIterator in class IPAddressSection
  - blockIterator
```
public java.util.Iterator<IPv4AddressSection> blockIterator(int segmentCount)
```
    Description copied from interface: IPAddressSegmentSeries
    
    Iterates through series that can be obtained by iterating through all the upper segments up to the given segment count. Segments following remain the same in all iterated series.
    For instance, given the IPv4 subnet 1-2.3-4.5-6.7, given the count argument 2, it will iterate through 1.3.5-6.7, 1.4.5-6.7, 2.3.5-6.7, 2.4.5-6.7
    
    Specified by:
    
    blockIterator in interface IPAddressSegmentSeries
    
    Specified by:
    
    blockIterator in class IPAddressSection
    
    Returns:
  - sequentialBlockIterator
```
public java.util.Iterator<IPv4AddressSection> sequentialBlockIterator()
```
    Description copied from interface: IPAddressSegmentSeries
    
    Iterates through the sequential series that make up this series. Generally this means finding the count of segments for which the segments that follow are not full range, and the using IPAddressSegmentSeries.blockIterator(int) with that segment count.
    For instance, given the IPv4 subnet 1-2.3-4.5-6.7-8, it will iterate through 1.3.5.7-8, 1.3.6.7-8, 1.4.5.7-8, 1.4.6.7-8, 2.3.5.7-8, 2.3.6.7-8, 2.4.6.7-8, 2.4.6.7-8
    
    Specified by:
    
    sequentialBlockIterator in interface IPAddressSegmentSeries
    
    Overrides:
    
    sequentialBlockIterator in class IPAddressSection
    
    Returns:
  - segmentsNonZeroHostIterator
```
public java.util.Iterator<IPv4AddressSegment[]> segmentsNonZeroHostIterator()
```
    Description copied from interface: IPAddressSegmentSeries
    
    Similar to the segments iterator, but series with a host of zero are skipped.
    
    Specified by:
    
    segmentsNonZeroHostIterator in interface IPAddressSegmentSeries
    
    Returns:
  - segmentsIterator
```
public java.util.Iterator<IPv4AddressSegment[]> segmentsIterator()
```
    Description copied from interface: AddressSegmentSeries
    
    Iterates through the individual segments.
    
    Specified by:
    
    segmentsIterator in interface AddressSegmentSeries
    
    Specified by:
    
    segmentsIterator in interface IPAddressSegmentSeries
  - incrementBoundary
```
public IPv4AddressSection incrementBoundary(long increment)
```
    Description copied from interface: AddressSegmentSeries
    
    If the given increment is positive, adds the value to the upper series (AddressSegmentSeries.getUpper() in the subnet range to produce a new series. If the given increment is negative, adds the value to the lower series (AddressSegmentSeries.getLower() in the subnet range to produce a new series. If the increment is zero, returns this.
    In the case where the series is a single value, this simply returns the address produced by adding the given increment to this address series.
    
    Specified by:
    
    incrementBoundary in interface AddressSection
    
    Specified by:
    
    incrementBoundary in interface AddressSegmentSeries
    
    Specified by:
    
    incrementBoundary in interface IPAddressSegmentSeries
    
    Specified by:
    
    incrementBoundary in class IPAddressSection
    
    Returns:
  - increment
```
public IPv4AddressSection increment(long increment)
```
    Description copied from interface: AddressSegmentSeries
    
    Returns the series from the subnet that is the given increment upwards into the subnet range, with the increment of 0 returning the first address in the range.
    If the subnet has multiple values and the increment exceeds the subnet size, then the amount by which it exceeds the size - 1 is added to the upper series of the range (the final iterator value).
    If the increment is negative, it is added to the lower series of the range (the first iterator value).
    If the subnet is just a single address values, the series is simply incremented by the given value, positive or negative.
    If a subnet has multiple values, a positive increment value is equivalent to the same number of values from the AddressSegmentSeries.iterator() For instance, a increment of 0 is the first value from the iterator, an increment of 1 is the second value from the iterator, and so on. A negative increment added to the subnet count is equivalent to the same number of values preceding the upper bound of the iterator. For instance, an increment of count - 1 is the last value from the iterator, an increment of count - 2 is the second last value, and so on.
    An increment of size count gives you the series just above the highest series of the subnet. To get the series just below the lowest series of the subnet, use the increment -1.
    
    Specified by:
    
    increment in interface AddressSection
    
    Specified by:
    
    increment in interface AddressSegmentSeries
    
    Specified by:
    
    increment in interface IPAddressSegmentSeries
    
    Specified by:
    
    increment in class IPAddressSection
    
    Returns:
  - getIPv4Count
```
public long getIPv4Count(boolean excludeZeroHosts)
```
  - getIPv4PrefixCount
```
public long getIPv4PrefixCount(int prefixLength)
```
  - getPrefixCount
```
public java.math.BigInteger getPrefixCount(int prefixLength)
```
    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.
    
    Specified by:
    
    getPrefixCount in interface AddressDivisionSeries
    
    Specified by:
    
    getPrefixCount in interface AddressItem
    
    Returns:
  - getIPv4PrefixCount
```
public long getIPv4PrefixCount()
```
  - getDivision
```
public IPv4AddressSegment getDivision(int index)
```
    Specified by:
    
    getDivision in interface AddressDivisionSeries
    
    Specified by:
    
    getDivision in interface IPAddressDivisionSeries
    
    Specified by:
    
    getDivision in interface inet.ipaddr.format.string.AddressStringDivisionSeries
    
    Specified by:
    
    getDivision in interface inet.ipaddr.format.string.IPAddressStringDivisionSeries
    
    Overrides:
    
    getDivision in class IPAddressSection
    
    Returns:
    
    the given division in this series. The first is at index 0.
  - getSegment
```
public IPv4AddressSegment getSegment(int index)
```
    Description copied from interface: AddressSegmentSeries
    
    Returns the segment from this series at the given index.
    
    Specified by:
    
    getSegment in interface AddressSegmentSeries
    
    Specified by:
    
    getSegment in interface IPAddressSegmentSeries
    
    Overrides:
    
    getSegment in class IPAddressSection
    
    Returns:
  - 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()
```
    Description copied from interface: AddressSegmentSeries
    
    Returns the number of bits comprising each segment in this series. Segments in the same series are equal length.
    
    Specified by:
    
    getBitsPerSegment in interface AddressSegmentSeries
    
    Returns:
  - getBytesPerSegment
```
public int getBytesPerSegment()
```
    Description copied from interface: AddressSegmentSeries
    
    Returns the number of bytes comprising each segment in this series. Segments in the same series are equal length.
    
    Specified by:
    
    getBytesPerSegment in interface AddressSegmentSeries
    
    Returns:
  - getBitCount
```
public int getBitCount()
```
    Specified by:
    
    getBitCount in interface AddressDivisionSeries
    
    Specified by:
    
    getBitCount in interface AddressItem
    
    Overrides:
    
    getBitCount in class IPAddressSection
    
    Returns:
    
    the number of bits comprising this address item
  - getByteCount
```
public int getByteCount()
```
    Specified by:
    
    getByteCount in interface AddressItem
    
    Overrides:
    
    getByteCount in class IPAddressSection
    
    Returns:
    
    the number of bytes required for this address item, rounding up if the bit count is not a multiple of 8
  - isIPv4
```
public boolean isIPv4()
```
    Overrides:
    
    isIPv4 in class IPAddressSection
  - getIPVersion
```
public IPAddress.IPVersion getIPVersion()
```
    Description copied from interface: IPAddressSegmentSeries
    
    Returns the version of this segment series
    
    Specified by:
    
    getIPVersion in interface IPAddressSegmentSeries
    
    Returns:
  - matchesWithMask
```
public boolean matchesWithMask(IPAddressSection other,
                               IPAddressSection mask)
```
    Description copied from class: IPAddressSection
    
    Applies the mask to this address section and then compares values with the given address section
    
    Overrides:
    
    matchesWithMask in class IPAddressSection
    
    Returns:
  - equals
```
public boolean equals(java.lang.Object o)
```
    Description copied from class: AddressDivisionGroupingBase
    
    Two groupings are equal if: - they match type/version (ipv4, ipv6, mac, or a specific grouping class) - they match division counts - each division matches bit counts - each division matches their specific grouping class - each division matches values Prefix lengths, for those groupings and/or divisionsS that have them, are ignored.
    
    Overrides:
    
    equals in class inet.ipaddr.format.standard.IPAddressDivisionGrouping
  - 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
    
    Overrides:
    
    contains in class IPAddressSection
    
    Returns:
    
    whether this subnet contains the given address section
  - prefixEquals
```
public boolean prefixEquals(AddressSection other)
```
    Description copied from interface: AddressSection
    
    Determines if the argument section matches this section up to the prefix length of this section.
    The entire prefix of this section must be present in the other section to be comparable.
    For sections which are aware of their position in an address (IPv6 and MAC), the argument section must have the same or an earlier position in the address to match all prefix segments of this section, and the matching is lined up relative to the position.
    
    Specified by:
    
    prefixEquals in interface AddressSection
    
    Returns:
    
    whether thie argument section has the same address section prefix as this
  - append
```
public IPv4AddressSection append(IPv4AddressSection other)
```
  - insert
```
public IPv4AddressSection insert(int index,
                                 IPv4AddressSection other)
```
  - replace
```
public IPv4AddressSection replace(int index,
                                  IPv4AddressSection other)
```
    Replace the segments of this section starting at the given index with the given replacement segments
    
    Parameters:
    
    index -
    
    other -
    
    Returns:
  - appendToNetwork
```
public IPv4AddressSection appendToNetwork(IPv4AddressSection other)
```
  - replace
```
public IPv4AddressSection replace(int startIndex,
                                  int endIndex,
                                  IPv4AddressSection replacement,
                                  int replacementStartIndex,
                                  int replacementEndIndex)
```
    Replaces segments starting from startIndex and ending before endIndex with the segments starting at replacementStartIndex and ending before replacementEndIndex from the replacement section
    
    Parameters:
    
    startIndex -
    
    endIndex -
    
    replacement -
    
    replacementStartIndex -
    
    replacementEndIndex -
    
    Returns:
    
    Throws:
    
    java.lang.IndexOutOfBoundsException
    
    IncompatibleAddressException - if the resulting section would exceed the maximum segment count for this address type and version
  - intersect
```
public IPv4AddressSection intersect(IPv4AddressSection other)
                             throws SizeMismatchException
```
    Produces the subnet sections whose addresses are found in both this and the given argument.
    This is also known as the conjunction of the two sets of address sections.
    
    Parameters:
    
    other -
    
    Returns:
    
    the section containing the sections found in both this and the given subnet sections
    
    Throws:
    
    SizeMismatchException
  - subtract
```
public IPv4AddressSection[] subtract(IPv4AddressSection other)
                              throws SizeMismatchException
```
    Subtract the given 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. This is also known as the relative complement of the given argument in this subnet.
    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:
    
    SizeMismatchException - if the two sections are different sizes
  - getNetwork
```
public IPv4AddressNetwork getNetwork()
```
    Description copied from interface: AddressSegmentSeries
    
    Returns the network object for series of the same version (eg IPv4, IPv6 and MAC each have their own network object)
    
    Specified by:
    
    getNetwork in interface AddressSegmentSeries
    
    Specified by:
    
    getNetwork in interface inet.ipaddr.format.string.IPAddressStringDivisionSeries
    
    Specified by:
    
    getNetwork in interface IPAddressSegmentSeries
    
    Overrides:
    
    getNetwork in class inet.ipaddr.format.standard.IPAddressDivisionGrouping
  - adjustPrefixBySegment
```
public IPv4AddressSection adjustPrefixBySegment(boolean nextSegment)
```
    Description copied from interface: AddressSegmentSeries
    
    Increases or decreases prefix length to the next segment boundary.
    Follows the same rules as AddressSegmentSeries.adjustPrefixLength(int):
    When prefix length is increased, the bits moved within the prefix become zero. When a prefix length is decreased, the bits moved outside the prefix become zero.
    
    Specified by:
    
    adjustPrefixBySegment in interface AddressSection
    
    Specified by:
    
    adjustPrefixBySegment in interface AddressSegmentSeries
    
    Specified by:
    
    adjustPrefixBySegment in interface IPAddressSegmentSeries
    
    Specified by:
    
    adjustPrefixBySegment in class IPAddressSection
    
    Parameters:
    
    nextSegment - whether to move prefix to previous or following segment coundary
    
    Returns:
  - adjustPrefixBySegment
```
public IPv4AddressSection adjustPrefixBySegment(boolean nextSegment,
                                                boolean zeroed)
```
    Description copied from interface: AddressSegmentSeries
    
    Increases or decreases prefix length to the next segment boundary.
    
    Specified by:
    
    adjustPrefixBySegment in interface AddressSection
    
    Specified by:
    
    adjustPrefixBySegment in interface AddressSegmentSeries
    
    Specified by:
    
    adjustPrefixBySegment in interface IPAddressSegmentSeries
    
    Overrides:
    
    adjustPrefixBySegment in class IPAddressSection
    
    Parameters:
    
    nextSegment - whether to move prefix to previous or following segment coundary
    
    zeroed - whether the bits that move from one side of the prefix to the other become zero or retain their original values
    
    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. When a prefix length is decreased, the bits moved outside the prefix become zero.
    
    Specified by:
    
    adjustPrefixLength in interface AddressSection
    
    Specified by:
    
    adjustPrefixLength in interface AddressSegmentSeries
    
    Specified by:
    
    adjustPrefixLength in interface IPAddressSegmentSeries
    
    Specified by:
    
    adjustPrefixLength in class IPAddressSection
    
    Returns:
  - adjustPrefixLength
```
public IPv4AddressSection adjustPrefixLength(int adjustment,
                                             boolean zeroed)
```
    Description copied from interface: AddressSegmentSeries
    
    Increases or decreases prefix length by the given increment.
    
    Specified by:
    
    adjustPrefixLength in interface AddressSection
    
    Specified by:
    
    adjustPrefixLength in interface AddressSegmentSeries
    
    Specified by:
    
    adjustPrefixLength in interface IPAddressSegmentSeries
    
    Specified by:
    
    adjustPrefixLength in class IPAddressSection
    
    Parameters:
    
    adjustment - the increment
    
    zeroed - whether the bits that move from one side of the prefix to the other become zero or retain their original values
    
    Returns:
  - applyPrefixLength
```
public IPv4AddressSection applyPrefixLength(int networkPrefixLength)
```
    Description copied from interface: AddressSegmentSeries
    
    Applies the given prefix length to create a new segment series.
    Similar to AddressSegmentSeries.setPrefixLength(int) except that prefix lengths are never increased. When this series already has a prefix length that is less than or equal to the requested prefix length, this series is returned.
    Otherwise the returned series has the given prefix length.
    The bits moved outside the prefix will become zero in the returned series.
    
    Specified by:
    
    applyPrefixLength in interface AddressSection
    
    Specified by:
    
    applyPrefixLength in interface AddressSegmentSeries
    
    Specified by:
    
    applyPrefixLength in interface IPAddressSegmentSeries
    
    Specified by:
    
    applyPrefixLength in class IPAddressSection
    
    Returns:
    
    See Also:
    
    AddressSegmentSeries.setPrefixLength(int)
  - setPrefixLength
```
public IPv4AddressSection setPrefixLength(int networkPrefixLength)
```
    Description copied from interface: AddressSegmentSeries
    
    Sets the prefix length.
    If this series has a prefix length, and the 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.
    The bits that move from one side of the prefix length to the other (ie bits moved into the prefix or outside the prefix) are zeroed.
    
    Specified by:
    
    setPrefixLength in interface AddressSection
    
    Specified by:
    
    setPrefixLength in interface AddressSegmentSeries
    
    Specified by:
    
    setPrefixLength in interface IPAddressSegmentSeries
    
    Specified by:
    
    setPrefixLength in class IPAddressSection
    
    Returns:
    
    See Also:
    
    AddressSegmentSeries.applyPrefixLength(int)
  - setPrefixLength
```
public IPv4AddressSection setPrefixLength(int networkPrefixLength,
                                          boolean withZeros)
```
    Description copied from interface: AddressSegmentSeries
    
    Sets the prefix length.
    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 interface IPAddressSegmentSeries
    
    Specified by:
    
    setPrefixLength in class IPAddressSection
    
    withZeros - whether the bits that move from one side of the prefix length to the other (ie bits moved into the prefix or outside the prefix) are zeroed.
    
    Returns:
  - removePrefixLength
```
public IPv4AddressSection removePrefixLength()
```
    Description copied from interface: IPAddressSegmentSeries
    
    Removes the prefix length. The bits that were host bits become zero.
    
    Specified by:
    
    removePrefixLength in interface AddressSection
    
    Specified by:
    
    removePrefixLength in interface AddressSegmentSeries
    
    Specified by:
    
    removePrefixLength in interface IPAddressSegmentSeries
    
    Specified by:
    
    removePrefixLength in class IPAddressSection
    
    Returns:
    
    See Also:
    
    IPAddressSegmentSeries.removePrefixLength(boolean)
  - withoutPrefixLength
```
public IPv4AddressSection withoutPrefixLength()
```
    Description copied from interface: AddressSegmentSeries
    
    Provides the same address with no prefix. Equivalent to calling withoutPrefixLength()
    
    Specified by:
    
    withoutPrefixLength in interface AddressSection
    
    Specified by:
    
    withoutPrefixLength in interface AddressSegmentSeries
    
    Specified by:
    
    withoutPrefixLength in interface IPAddressSegmentSeries
    
    Specified by:
    
    withoutPrefixLength in class IPAddressSection
  - removePrefixLength
```
public IPv4AddressSection removePrefixLength(boolean zeroed)
```
    Description copied from interface: IPAddressSegmentSeries
    
    Removes the prefix length. If zeroed is false, the bits that were host bits do not become zero, unlike IPAddressSegmentSeries.removePrefixLength()
    
    Specified by:
    
    removePrefixLength in interface AddressSection
    
    Specified by:
    
    removePrefixLength in interface AddressSegmentSeries
    
    Specified by:
    
    removePrefixLength in interface IPAddressSegmentSeries
    
    Specified by:
    
    removePrefixLength in class IPAddressSection
    
    Parameters:
    
    zeroed - whether the host bits become zero.
    
    Returns:
  - toZeroHost
```
public IPv4AddressSection toZeroHost()
                              throws IncompatibleAddressException
```
    Description copied from interface: IPAddressSegmentSeries
    
    Returns the segment series with a host of zero. If the series has no prefix length, then it returns an all-zero series.
    The resultant series will have the same prefix length if AddressNetwork.getPrefixConfiguration() is not AddressNetwork.PrefixConfiguration.ALL_PREFIXED_ADDRESSES_ARE_SUBNETS, otherwise it will no longer have a prefix length.
    For instance, you can get the network address for a subnet as follows: String addrStr = "1.2.3.4/16"; IPAddress address = new IPAddressString(addrStr).getAddress(); IPAddress networkAddress = address.toZeroHost(); //1.2.0.0
    
    Specified by:
    
    toZeroHost in interface IPAddressSegmentSeries
    
    Specified by:
    
    toZeroHost in class IPAddressSection
    
    Returns:
    
    Throws:
    
    IncompatibleAddressException
  - toZeroHost
```
public IPv4AddressSection toZeroHost(int prefixLength)
```
    Description copied from interface: IPAddressSegmentSeries
    
    Produces the series with host values of 0 for the given prefix length.
    If this series has the same prefix length, then the resulting series will too, otherwise the resulting series will have no prefix length.
    This is nearly equivalent to doing the mask (bitwise conjunction) of this address series with the network mask for the given prefix length, but without the possibility of IncompatibleAddressException that can occur when applying a mask to a range of values. Instead, in this case, if the resulting series has a range of values, then the resulting series range boundaries will have host values of 0, but not necessarily the intervening values.
    For instance, you can get the network address for a subnet of prefix length 16 as follows: String addrStr = "1.2.3.4"; IPAddress address = new IPAddressString(addrStr).getAddress(); IPAddress networkAddress = address.toZeroHost(16); //1.2.0.0
    
    Specified by:
    
    toZeroHost in interface IPAddressSegmentSeries
    
    Specified by:
    
    toZeroHost in class IPAddressSection
    
    Returns:
  - toMaxHost
```
public IPv4AddressSection toMaxHost()
                             throws IncompatibleAddressException
```
    Description copied from interface: IPAddressSegmentSeries
    
    Returns the segment series with a host of all ones. If the series has no prefix length, then it returns an all-ones series.
    The resultant series will have the same prefix length if AddressNetwork.getPrefixConfiguration() is not AddressNetwork.PrefixConfiguration.ALL_PREFIXED_ADDRESSES_ARE_SUBNETS, otherwise it will no longer have a prefix length.
    For instance, you can get the broadcast address for a subnet as follows: String addrStr = "1.2.3.4/16"; IPAddress address = new IPAddressString(addrStr).getAddress(); IPAddress broadcastAddress = address.toMaxHost(); //1.2.255.255
    
    Specified by:
    
    toMaxHost in interface IPAddressSegmentSeries
    
    Specified by:
    
    toMaxHost in class IPAddressSection
    
    Returns:
    
    Throws:
    
    IncompatibleAddressException
  - createMaxHost
```
public IPv4AddressSection createMaxHost()
```
  - toMaxHost
```
public IPv4AddressSection toMaxHost(int prefixLength)
```
    Description copied from interface: IPAddressSegmentSeries
    
    Produces the series with host values of all one bits for the given prefix length.
    If this series has the same prefix length, then the resulting series will too, otherwise the resulting series will have no prefix length.
    This is nearly equivalent to doing the bitwise or (bitwise disjunction) of this address series with the network mask for the given prefix length, but without the possibility of IncompatibleAddressException that can occur when applying a mask to a range of values. Instead, in this case, if the resulting series has a range of values, then the resulting series range boundaries will have host values of all ones, but not necessarily the intervening values.
    For instance, you can get the broadcast address for a subnet of prefix length 16 as follows: String addrStr = "1.2.3.4"; IPAddress address = new IPAddressString(addrStr).getAddress(); IPAddress broadcastAddress = address.toMaxHost(16); //1.2.255.255
    
    Specified by:
    
    toMaxHost in interface IPAddressSegmentSeries
    
    Specified by:
    
    toMaxHost in class IPAddressSection
    
    Returns:
  - mask
```
public IPv4AddressSection mask(IPv4AddressSection mask,
                               boolean retainPrefix)
                        throws IncompatibleAddressException,
                               PrefixLenException,
                               SizeMismatchException
```
    Does the bitwise conjunction with this address. Useful when subnetting.
    
    Parameters:
    
    mask -
    
    retainPrefix - whether to drop the prefix
    
    Returns:
    
    Throws:
    
    IncompatibleAddressException
    
    PrefixLenException
    
    SizeMismatchException
  - mask
```
public IPv4AddressSection mask(IPv4AddressSection mask)
                        throws IncompatibleAddressException
```
    Equivalent to mask(IPv4AddressSection, boolean) with the second argument as false.
    
    Throws:
    
    IncompatibleAddressException
  - maskNetwork
```
public IPv4AddressSection maskNetwork(IPv4AddressSection mask,
                                      int networkPrefixLength)
                               throws IncompatibleAddressException,
                                      PrefixLenException,
                                      SizeMismatchException
```
    Produces the bitwise conjunction of the given mask with 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(int, IPv4AddressSection)
    
    Parameters:
    
    mask -
    
    networkPrefixLength -
    
    Returns:
    
    Throws:
    
    IncompatibleAddressException
    
    PrefixLenException
    
    SizeMismatchException
  - bitwiseOr
```
public IPv4AddressSection bitwiseOr(IPv4AddressSection mask)
                             throws IncompatibleAddressException
```
    Equivalent to bitwiseOr(IPv4AddressSection, boolean) with the second argument as false.
    
    Throws:
    
    IncompatibleAddressException
  - bitwiseOr
```
public IPv4AddressSection bitwiseOr(IPv4AddressSection mask,
                                    boolean retainPrefix)
                             throws IncompatibleAddressException,
                                    SizeMismatchException
```
    Does the bitwise disjunction with this address section. Useful when subnetting. Similar to mask(IPv4AddressSection) which does the bitwise conjunction.
    
    Parameters:
    
    retainPrefix - whether the result will retain the same prefix length as this.
    
    Returns:
    
    Throws:
    
    IncompatibleAddressException
    
    SizeMismatchException
  - bitwiseOrNetwork
```
public IPv4AddressSection bitwiseOrNetwork(IPv4AddressSection mask,
                                           int networkPrefixLength)
                                    throws IncompatibleAddressException,
                                           SizeMismatchException
```
    Does the bitwise disjunction with this address section. Useful when subnetting. Similar to maskNetwork(IPv4AddressSection, int) which does the bitwise conjunction.
    Any existing prefix length is dropped for the new prefix length and the disjunction is applied up to the end the new prefix length.
    
    Parameters:
    
    mask -
    
    Returns:
    
    Throws:
    
    IncompatibleAddressException
    
    SizeMismatchException
  - getNetworkSection
```
public IPv4AddressSection getNetworkSection()
```
    Description copied from interface: IPAddressSegmentSeries
    
    Returns the network section of the series if the series has a CIDR network prefix length, otherwise it returns the entire series as a prefixed series with prefix matching the address bit length.
    
    Specified by:
    
    getNetworkSection in interface IPAddressSegmentSeries
    
    Returns:
  - getNetworkSection
```
public IPv4AddressSection getNetworkSection(int networkPrefixLength)
                                     throws PrefixLenException
```
    Description copied from interface: IPAddressSegmentSeries
    
    Returns the network section of the series. The returned section will have only as many segments as needed as indicated by networkPrefixLength. It will have networkPrefixLength as its associated prefix length, unless this address already has a smaller prefix length, in which case the existing prefix length is retained.
    
    Specified by:
    
    getNetworkSection in interface IPAddressSegmentSeries
    
    Returns:
    
    Throws:
    
    PrefixLenException
  - getNetworkSection
```
public IPv4AddressSection getNetworkSection(int networkPrefixLength,
                                            boolean withPrefixLength)
                                     throws PrefixLenException
```
    Description copied from interface: IPAddressSegmentSeries
    
    Returns the network section of the series. The returned section will have only as many segments as needed as indicated by networkPrefixLength. If withPrefixLength is true, it will have networkPrefixLength as its associated prefix length, unless this series already has a smaller prefix length, in which case the existing prefix length is retained.
    
    Specified by:
    
    getNetworkSection in interface IPAddressSegmentSeries
    
    withPrefixLength - whether the resulting section will have networkPrefixLength as the associated prefix length or not
    
    Returns:
    
    Throws:
    
    PrefixLenException
  - getHostSection
```
public IPv4AddressSection getHostSection()
```
    Description copied from interface: IPAddressSegmentSeries
    
    Returns the host section of the series. The returned section will have only as many segments as needed as determined by the existing CIDR network prefix length. If this series has no CIDR prefix length, the returned host section will be the full section associated with a prefix length of 0.
    
    Specified by:
    
    getHostSection in interface IPAddressSegmentSeries
    
    Returns:
  - getHostSection
```
public IPv4AddressSection getHostSection(int networkPrefixLength)
                                  throws PrefixLenException
```
    Description copied from interface: IPAddressSegmentSeries
    
    Returns the host section of the address as indicated by the network prefix length provided. The returned section will have only as many segments as needed to hold the host as indicated by the provided network prefix length.
    
    Specified by:
    
    getHostSection in interface IPAddressSegmentSeries
    
    Returns:
    
    Throws:
    
    PrefixLenException
  - toPrefixBlock
```
public IPv4AddressSection toPrefixBlock()
```
    Description copied from interface: IPAddressSegmentSeries
    
    If this series has a prefix length, returns the subnet block for that prefix. If this series has no prefix length, this series is returned.
    
    Specified by:
    
    toPrefixBlock in interface AddressSection
    
    Specified by:
    
    toPrefixBlock in interface AddressSegmentSeries
    
    Specified by:
    
    toPrefixBlock in interface IPAddressSegmentSeries
    
    Specified by:
    
    toPrefixBlock in class IPAddressSection
    
    Returns:
    
    the subnet block for the prefix length
  - toPrefixBlock
```
public IPv4AddressSection toPrefixBlock(int networkPrefixLength)
                                 throws PrefixLenException
```
    Description copied from interface: IPAddressSegmentSeries
    
    Returns the segment series of the same length that spans all hosts. The network prefix length will be the one provided, and the network values will match the same of this series.
    
    Specified by:
    
    toPrefixBlock in interface IPAddressSegmentSeries
    
    Specified by:
    
    toPrefixBlock in class IPAddressSection
    
    Returns:
    
    Throws:
    
    PrefixLenException
  - assignPrefixForSingleBlock
```
public IPv4AddressSection assignPrefixForSingleBlock()
```
    Description copied from class: IPAddressSection
    
    Returns the equivalent CIDR address section with a prefix length for which the subnet block for that prefix matches the range of values in this section.
    If no such prefix length exists, returns null.
    If this address represents just a single address, "this" is returned.
    
    Specified by:
    
    assignPrefixForSingleBlock in interface IPAddressSegmentSeries
    
    Overrides:
    
    assignPrefixForSingleBlock in class IPAddressSection
    
    Returns:
    
    See Also:
    
    IPAddressSegmentSeries.toPrefixBlock(), IPAddressSegmentSeries.assignMinPrefixForBlock()
  - assignMinPrefixForBlock
```
public IPv4AddressSection assignMinPrefixForBlock()
```
    Description copied from class: IPAddressSection
    
    Constructs an equivalent address section with the smallest CIDR prefix possible (largest network), such that the range of values are a set of subnet blocks for that prefix.
    
    Specified by:
    
    assignMinPrefixForBlock in interface IPAddressSegmentSeries
    
    Overrides:
    
    assignMinPrefixForBlock in class IPAddressSection
    
    Returns:
    
    See Also:
    
    IPAddressSegmentSeries.toPrefixBlock(), IPAddressSegmentSeries.assignPrefixForSingleBlock()
  - spanWithPrefixBlocks
```
public IPv4AddressSection[] spanWithPrefixBlocks(IPv4AddressSection other)
```
    Produces the list of prefix block subnets that span from this series to the given series.
    
    Parameters:
    
    other -
    
    Returns:
  - spanWithRangedSegments
```
public IPv4AddressSection[] spanWithRangedSegments(IPv4AddressSection other)
```
    Produces a list of range subnets that span from this series to the given series.
    
    Parameters:
    
    other -
    
    Returns:
  - mergePrefixBlocks
```
public IPv4AddressSection[] mergePrefixBlocks(IPv4AddressSection... sections)
                                       throws SizeMismatchException
```
    Merges this with the list of sections to produce the smallest array of prefix blocks, going from smallest to largest
    
    Parameters:
    
    sections - the sections to merge with this
    
    Returns:
    
    Throws:
    
    SizeMismatchException
  - mergeToSequentialBlocks
```
public IPv4AddressSection[] mergeToSequentialBlocks(IPv4AddressSection... sections)
                                             throws SizeMismatchException
```
    Merges this with the list of sections to produce the smallest array of sequential block subnets, going from smallest to largest
    
    Parameters:
    
    sections - the sections to merge with this
    
    Returns:
    
    Throws:
    
    SizeMismatchException
  - toCanonicalString
```
public java.lang.String toCanonicalString()
```
    This produces a canonical string. If this has a prefix length, that will be included in the 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 interface IPAddressSegmentSeries
  - 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
    
    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 toCanonicalString().
    
    Specified by:
    
    toNormalizedString in interface AddressComponent
    
    Returns:
  - toCompressedWildcardString
```
public java.lang.String toCompressedWildcardString()
```
    Description copied from interface: IPAddressSegmentSeries
    
    This is similar to toNormalizedWildcardString, avoiding the CIDR prefix, but with compression as well.
    
    Specified by:
    
    toCompressedWildcardString in interface IPAddressSegmentSeries
  - toSubnetString
```
public java.lang.String toSubnetString()
```
    Description copied from interface: IPAddressSegmentSeries
    
    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 interface IPAddressSegmentSeries
  - toPrefixLengthString
```
public java.lang.String toPrefixLengthString()
```
    Description copied from interface: IPAddressSegmentSeries
    
    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 interface IPAddressSegmentSeries
    
    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 interface: IPAddressSegmentSeries
    
    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 interface IPAddressSegmentSeries
  - toCanonicalWildcardString
```
public java.lang.String toCanonicalWildcardString()
```
    Description copied from interface: IPAddressSegmentSeries
    
    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 interface IPAddressSegmentSeries
  - toSQLWildcardString
```
public java.lang.String toSQLWildcardString()
```
    Description copied from interface: IPAddressSegmentSeries
    
    This is the same as the string from toNormalizedWildcardString except that it uses Address.SEGMENT_SQL_WILDCARD instead of Address.SEGMENT_WILDCARD and also uses Address.SEGMENT_SQL_SINGLE_WILDCARD
    
    Specified by:
    
    toSQLWildcardString in interface IPAddressSegmentSeries
  - toReverseDNSLookupString
```
public java.lang.String toReverseDNSLookupString()
```
    Description copied from interface: IPAddressSegmentSeries
    
    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 interface IPAddressSegmentSeries
    
    Returns:
  - toNormalizedString
```
public java.lang.String toNormalizedString(IPAddressSection.IPStringOptions stringParams,
                                           int joinCount)
```
  - toJoinedSegments
```
public inet.ipaddr.format.standard.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 interface IPAddressSegmentSeries
  - toStringCollection
```
public IPAddressPartStringCollection toStringCollection(IPv4AddressSection.IPv4StringBuilderOptions opts)
```
  - getParts
```
public inet.ipaddr.format.string.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 inet.ipaddr.format.string.IPAddressStringDivisionSeries[] getParts(IPv4AddressSection.IPv4StringBuilderOptions options)
```

Class IPv4AddressSection

Nested Class Summary

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

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

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

Constructor Summary

Method Summary

Methods inherited from class inet.ipaddr.IPAddressSection

Methods inherited from class inet.ipaddr.format.standard.IPAddressDivisionGrouping

Methods inherited from class inet.ipaddr.format.standard.AddressDivisionGrouping

Methods inherited from class inet.ipaddr.format.AddressDivisionGroupingBase

Methods inherited from class java.lang.Object

Methods inherited from interface java.lang.Iterable

Methods inherited from interface inet.ipaddr.format.IPAddressDivisionSeries

Methods inherited from interface inet.ipaddr.format.string.IPAddressStringDivisionSeries

Methods inherited from interface inet.ipaddr.format.AddressDivisionSeries

Methods inherited from interface inet.ipaddr.format.string.AddressStringDivisionSeries

Constructor Detail

IPv4AddressSection

IPv4AddressSection

IPv4AddressSection

IPv4AddressSection

IPv4AddressSection

IPv4AddressSection

IPv4AddressSection

IPv4AddressSection

IPv4AddressSection

IPv4AddressSection

IPv4AddressSection

IPv4AddressSection

IPv4AddressSection

Method Detail

getSegments

getSection

getSection

getSection

getLowerNonZeroHost

getLower

getUpper

intValue

upperIntValue

longValue

upperLongValue

reverseBits

reverseBytes

reverseBytesPerSegment

reverseSegments

getIterable

nonZeroHostIterator

iterator

prefixIterator

prefixBlockIterator

blockIterator

sequentialBlockIterator

segmentsNonZeroHostIterator

segmentsIterator

incrementBoundary

increment

getIPv4Count

getIPv4PrefixCount

getPrefixCount

getIPv4PrefixCount

getDivision

getSegment

getSegments

getSegments

getBitsPerSegment

getBytesPerSegment

getBitCount

getByteCount

isIPv4

getIPVersion

matchesWithMask

equals

contains

prefixEquals

append

insert

replace

appendToNetwork