IPv4AddressSection

java.lang.Object
- inet.ipaddr.format.IPAddressSegmentGrouping
- - inet.ipaddr.IPAddressSection
  - - inet.ipaddr.ipv4.IPv4AddressSection

All Implemented Interfaces:

IPAddressPart, java.io.Serializable, java.lang.Comparable<IPAddressSegmentGrouping>
```
public class IPv4AddressSection
extends IPAddressSection
```
See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class IPv4AddressSection.IPv4StringBuilderOptions
- Nested classes/interfaces inherited from class inet.ipaddr.IPAddressSection
  IPAddressSection.IPStringBuilderOptions, IPAddressSection.StringOptions, IPAddressSection.WildcardOptions
- Nested classes/interfaces inherited from class inet.ipaddr.format.IPAddressSegmentGrouping
  IPAddressSegmentGrouping.Range, IPAddressSegmentGrouping.RangeList

Nested Classes
Modifier and Type	Class and Description
`static class`	`IPv4AddressSection.IPv4StringBuilderOptions`

Constructor Summary

Constructors
Constructor and Description
`IPv4AddressSection(byte[] bytes)`
`IPv4AddressSection(byte[] bytes, java.lang.Integer prefix)`
`IPv4AddressSection(IPv4AddressSegment[] segments)`
`IPv4AddressSection(IPv4AddressSegment[] segments, java.lang.Integer networkPrefixLength)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`contains(IPAddressSection other)`
`boolean`	`equals(java.lang.Object o)`
`int`	`getBitsPerSegment()`
`int`	`getByteIndex(java.lang.Integer networkPrefixLength)`
`int`	`getBytesPerSegment()`
`IPv4AddressSection`	`getHostSection(int networkPrefixLength)`
`IPAddress.IPVersion`	`getIPVersion()`
`IPv4AddressSection`	`getLowerSection()` 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.
`IPv4AddressSegment[]`	`getLowerSegments()` If this represents an address section with ranging values, returns an array of address segments representing the lower values of the range If this represents an address section with a single value in each segment, returns an array containing the segments for this section.
`IPv4AddressNetwork`	`getNetwork()`
`IPv4AddressSection`	`getNetworkSection(int networkPrefixLength)`
`IPv4AddressSection`	`getNetworkSection(int networkPrefixLength, boolean withPrefixLength)`
`IPAddressPart[]`	`getParts(IPAddressSection.IPStringBuilderOptions options)` Get all representations of this address including this IPAddressSection.
`IPAddressPart[]`	`getParts(IPv4AddressSection.IPv4StringBuilderOptions options)`
`IPv4AddressSegment`	`getSegment(int index)`
`int`	`getSegmentIndex(java.lang.Integer networkPrefixLength)`
`IPv4AddressSegment[]`	`getSegments()`
`IPv4AddressSection`	`getUpperSection()` 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.
`IPv4AddressSegment[]`	`getUpperSegments()` If this represents an address section with ranging values, returns an an array of address segments representing the upper values of the rang If this represents an address section with a single value in each segment, returns an array containing the segments for this section.
`boolean`	`isIPv4()`
`java.util.Iterator<IPv4AddressSegment[]>`	`iterator()`
`java.util.Iterator<IPv4AddressSection>`	`sectionIterator()`
`IPv4AddressSection[]`	`subtract(IPAddressSection 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)`
`IPAddressSegmentGrouping`	`toJoinedSegments(int joinCount)`
`java.lang.String`	`toNetworkPrefixLengthString()` Returns a string with a CIDR prefix length if this section has a network prefix length.
`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.StringOptions stringParams, int joinCount)`
`java.lang.String`	`toNormalizedWildcardString()` This produces a string similar to the normalized string and avoids the CIDR prefix.
`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)`
`IPv4AddressSection`	`toSubnet(int networkPrefixLength)` Creates a subnet address using the given CIDR prefix bits.
`IPv4AddressSection`	`toSubnet(IPAddressSection mask)` Creates a subnet address using the given mask.
`IPv4AddressSection`	`toSubnet(IPAddressSection mask, java.lang.Integer networkPrefixLength)` Creates a subnet address using the given mask and prefix length.
`java.lang.String`	`toSubnetString()` Produces a consistent subnet string.

Methods inherited from class inet.ipaddr.format.IPAddressSegmentGrouping
compareTo, getCount, getDivision, getDivisionCount, getNetworkPrefixLength, getZeroRangeSegments, getZeroSegments, hashCode, isMultiple, isMultipleByNetworkPrefix, isPrefixed, isRangeEquivalentToPrefix, isZero

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface inet.ipaddr.format.IPAddressPart
getPrefixStringLength

- Constructor Detail
  - IPv4AddressSection
```
public IPv4AddressSection(IPv4AddressSegment[] segments,
                          java.lang.Integer networkPrefixLength)
```
  - IPv4AddressSection
```
public IPv4AddressSection(IPv4AddressSegment[] segments)
```
  - IPv4AddressSection
```
public IPv4AddressSection(byte[] bytes,
                          java.lang.Integer prefix)
```
  - IPv4AddressSection
```
public IPv4AddressSection(byte[] bytes)
```
- Method Detail
  - getSegments
```
public IPv4AddressSegment[] getSegments()
```
    Specified by:
    
    getSegments in class IPAddressSection
    
    Returns:
    
    an array containing the segments
  - getLowerSegments
```
public IPv4AddressSegment[] getLowerSegments()
```
    Description copied from class: IPAddressSection
    
    If this represents an address section with ranging values, returns an array of address segments representing the lower values of the range If this represents an address section with a single value in each segment, returns an array containing the segments for this section.
    
    Specified by:
    
    getLowerSegments in class IPAddressSection
    
    Returns:
  - getUpperSegments
```
public IPv4AddressSegment[] getUpperSegments()
```
    Description copied from class: IPAddressSection
    
    If this represents an address section with ranging values, returns an an array of address segments representing the upper values of the rang If this represents an address section with a single value in each segment, returns an array containing the segments for this section.
    
    Specified by:
    
    getUpperSegments in class IPAddressSection
    
    Returns:
  - getLowerSection
```
public IPv4AddressSection getLowerSection()
```
    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:
    
    getLowerSection in class IPAddressSection
    
    Returns:
  - getUpperSection
```
public IPv4AddressSection getUpperSection()
```
    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:
    
    getUpperSection in class IPAddressSection
    
    Returns:
  - sectionIterator
```
public java.util.Iterator<IPv4AddressSection> sectionIterator()
```
    Specified by:
    
    sectionIterator in class IPAddressSection
  - iterator
```
public java.util.Iterator<IPv4AddressSegment[]> iterator()
```
    Specified by:
    
    iterator in class IPAddressSection
  - getSegment
```
public IPv4AddressSegment getSegment(int index)
```
    Overrides:
    
    getSegment in class IPAddressSection
  - getBitsPerSegment
```
public int getBitsPerSegment()
```
    Specified by:
    
    getBitsPerSegment in class IPAddressSection
  - getBytesPerSegment
```
public int getBytesPerSegment()
```
    Specified by:
    
    getBytesPerSegment in class IPAddressSection
  - 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 IPAddressSegmentGrouping
  - contains
```
public boolean contains(IPAddressSection other)
```
    Overrides:
    
    contains in class IPAddressSection
    
    Returns:
    
    whether this subnet contains the given address section
  - subtract
```
public IPv4AddressSection[] subtract(IPAddressSection other)
```
    Description copied from class: IPAddressSection
    
    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.
    
    Specified by:
    
    subtract in class IPAddressSection
    
    Returns:
    
    the difference
  - getByteIndex
```
public int getByteIndex(java.lang.Integer networkPrefixLength)
```
    Specified by:
    
    getByteIndex in class IPAddressSection
  - getSegmentIndex
```
public int getSegmentIndex(java.lang.Integer networkPrefixLength)
```
    Specified by:
    
    getSegmentIndex in class IPAddressSection
  - getNetwork
```
public IPv4AddressNetwork getNetwork()
```
    Specified by:
    
    getNetwork in class IPAddressSection
  - toSubnet
```
public IPv4AddressSection toSubnet(int networkPrefixLength)
                            throws IPAddressTypeException
```
    Description copied from class: IPAddressSection
    
    Creates a subnet address using the given CIDR prefix bits.
    
    Specified by:
    
    toSubnet in class IPAddressSection
    
    Throws:
    
    IPAddressTypeException
  - toSubnet
```
public IPv4AddressSection toSubnet(IPAddressSection mask)
                            throws IPAddressTypeException
```
    Creates a subnet address using the given mask.
    
    Specified by:
    
    toSubnet in class IPAddressSection
    
    Throws:
    
    IPAddressTypeException
  - toSubnet
```
public IPv4AddressSection toSubnet(IPAddressSection mask,
                                   java.lang.Integer networkPrefixLength)
                            throws IPAddressTypeException
```
    Creates a subnet address using the given mask and prefix length.
    
    Specified by:
    
    toSubnet in class IPAddressSection
    
    Parameters:
    
    networkPrefixLength - if non-null, applies the given prefix
    
    Throws:
    
    IPAddressTypeException - if the mask is not compatible, see IPAddress.isMaskCompatibleWithRange(IPAddress, Integer)
  - 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 class IPAddressSection
  - 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 class IPAddressSection
  - 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 class IPAddressSection
  - 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
  - toNetworkPrefixLengthString
```
public java.lang.String toNetworkPrefixLengthString()
```
    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:
    
    toNetworkPrefixLengthString 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
  - toNormalizedString
```
public java.lang.String toNormalizedString(IPAddressSection.StringOptions stringParams,
                                           int joinCount)
```
  - toJoinedSegments
```
public IPAddressSegmentGrouping 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 IPAddressPart[] 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 IPAddressSegmentGrouping
    - conversions to IPv6, and alternative representations of those IPv6 addresses
    Overrides:
    
    getParts in class IPAddressSection
    
    Returns:
  - getParts
```
public IPAddressPart[] getParts(IPv4AddressSection.IPv4StringBuilderOptions options)
```

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

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

Methods inherited from class inet.ipaddr.IPAddressSection

Methods inherited from class inet.ipaddr.format.IPAddressSegmentGrouping

Methods inherited from class java.lang.Object

Methods inherited from interface inet.ipaddr.format.IPAddressPart

IPv4AddressSection

IPv4AddressSection

IPv4AddressSection

IPv4AddressSection

getSegments

getLowerSegments

getUpperSegments

getLowerSection

getUpperSection

sectionIterator

iterator

getSegment

getBitsPerSegment

getBytesPerSegment

isIPv4

getIPVersion

equals

contains

subtract

getByteIndex

getSegmentIndex

getNetwork

toSubnet

toSubnet

toSubnet

getNetworkSection

getNetworkSection

getHostSection

toCanonicalString

toFullString

toCompressedString

toNormalizedString

toCompressedWildcardString

toSubnetString

toNetworkPrefixLengthString

toInetAtonString

toInetAtonString

toNormalizedWildcardString

toCanonicalWildcardString

toSQLWildcardString

toNormalizedString

toJoinedSegments

toAllStringCollection

toStandardStringCollection

toDatabaseSearchStringCollection

toStringCollection

toStringCollection

getParts

getParts