# Inet4Address

public final class **Inet4Address** extends [InetAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html)  
This class represents an Internet Protocol version 4 (IPv4) address.
Defined by [*RFC 790: Assigned Numbers*](http://www.ietf.org/rfc/rfc790.txt),
[*RFC 1918: Address Allocation for Private Internets*](http://www.ietf.org/rfc/rfc1918.txt),
and [*RFC 2365: Administratively Scoped IP Multicast*](http://www.ietf.org/rfc/rfc2365.txt)

### Textual representation of IP addresses

Textual representation of IPv4 address used as input to methods takes one of the following forms:
>
> |---|
> | `d.d.d.d` |
> | `d.d.d` |
> | `d.d` |
> | `d` |

When four parts are specified, each is interpreted as a byte of
data and assigned, from left to right, to the four bytes of an IPv4
address.

When a three part address is specified, the last part is
interpreted as a 16-bit quantity and placed in the right most two
bytes of the network address. This makes the three part address
format convenient for specifying Class B net- work addresses as
128.net.host.

When a two part address is supplied, the last part is
interpreted as a 24-bit quantity and placed in the right most three
bytes of the network address. This makes the two part address
format convenient for specifying Class A network addresses as
net.host.

When only one part is given, the value is stored directly in
the network address without any byte rearrangement.

For methods that return a textual representation as output
value, the first form, i.e. a dotted-quad string, is used.

#### The Scope of a Multicast Address

Historically the IPv4 TTL field in the IP header has doubled as a multicast scope field: a TTL of 0 means node-local, 1 means link-local, up through 32 means site-local, up through 64 means region-local, up through 128 means continent-local, and up through 255 are global. However, the administrative scoping is preferred. Please refer to [*RFC 2365: Administratively Scoped IP Multicast*](http://www.ietf.org/rfc/rfc2365.txt)

<br />

### Public Method Summary

|---|---|
| boolean | [equals](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/Inet4Address.html#equals(java.lang.Object))([Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) obj) Compares this object against the specified object. |
| byte\[\] | [getAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/Inet4Address.html#getAddress())() Returns the raw IP address of this `InetAddress` object. |
| [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) | [getHostAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/Inet4Address.html#getHostAddress())() Returns the IP address string in textual presentation form. |
| int | [hashCode](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/Inet4Address.html#hashCode())() Returns a hashcode for this IP address. |
| boolean | [isAnyLocalAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/Inet4Address.html#isAnyLocalAddress())() Utility routine to check if the InetAddress in a wildcard address. |
| boolean | [isLinkLocalAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/Inet4Address.html#isLinkLocalAddress())() Utility routine to check if the InetAddress is an link local address. |
| boolean | [isLoopbackAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/Inet4Address.html#isLoopbackAddress())() Utility routine to check if the InetAddress is a loopback address. |
| boolean | [isMCGlobal](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/Inet4Address.html#isMCGlobal())() Utility routine to check if the multicast address has global scope. |
| boolean | [isMCLinkLocal](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/Inet4Address.html#isMCLinkLocal())() Utility routine to check if the multicast address has link scope. |
| boolean | [isMCNodeLocal](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/Inet4Address.html#isMCNodeLocal())() Utility routine to check if the multicast address has node scope. |
| boolean | [isMCOrgLocal](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/Inet4Address.html#isMCOrgLocal())() Utility routine to check if the multicast address has organization scope. |
| boolean | [isMCSiteLocal](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/Inet4Address.html#isMCSiteLocal())() Utility routine to check if the multicast address has site scope. |
| boolean | [isMulticastAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/Inet4Address.html#isMulticastAddress())() Utility routine to check if the InetAddress is an IP multicast address. |
| boolean | [isSiteLocalAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/Inet4Address.html#isSiteLocalAddress())() Utility routine to check if the InetAddress is a site local address. |

### Inherited Method Summary

From class [java.net.InetAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html)

|---|---|
| boolean | [equals](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#equals(java.lang.Object))([Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) obj) Compares this object against the specified object. |
| byte\[\] | [getAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#getAddress())() Returns the raw IP address of this `InetAddress` object. |
| static [InetAddress\[\]](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html) | [getAllByName](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#getAllByName(java.lang.String))([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) host) Given the name of a host, returns an array of its IP addresses, based on the configured name service on the system. |
| static [InetAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html) | [getByAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#getByAddress(byte[]))(byte\[\] addr) Returns an `InetAddress` object given the raw IP address . |
| static [InetAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html) | [getByAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#getByAddress(java.lang.String,%20byte[],%20int))([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) host, byte\[\] addr, int scopeId) |
| static [InetAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html) | [getByAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#getByAddress(java.lang.String,%20byte[]))([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) host, byte\[\] addr) Creates an InetAddress based on the provided host name and IP address. |
| static [InetAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html) | [getByName](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#getByName(java.lang.String))([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) host) Determines the IP address of a host, given the host's name. |
| [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) | [getCanonicalHostName](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#getCanonicalHostName())() Gets the fully qualified domain name for this IP address. |
| [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) | [getHostAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#getHostAddress())() Returns the IP address string in textual presentation. |
| [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) | [getHostName](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#getHostName())() Gets the host name for this IP address. |
| static [InetAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html) | [getLocalHost](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#getLocalHost())() Returns the address of the local host. |
| static [InetAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html) | [getLoopbackAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#getLoopbackAddress())() Returns the loopback address. |
| int | [hashCode](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#hashCode())() Returns a hashcode for this IP address. |
| boolean | [isAnyLocalAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#isAnyLocalAddress())() Utility routine to check if the InetAddress in a wildcard address. |
| boolean | [isLinkLocalAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#isLinkLocalAddress())() Utility routine to check if the InetAddress is an link local address. |
| boolean | [isLoopbackAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#isLoopbackAddress())() Utility routine to check if the InetAddress is a loopback address. |
| boolean | [isMCGlobal](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#isMCGlobal())() Utility routine to check if the multicast address has global scope. |
| boolean | [isMCLinkLocal](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#isMCLinkLocal())() Utility routine to check if the multicast address has link scope. |
| boolean | [isMCNodeLocal](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#isMCNodeLocal())() Utility routine to check if the multicast address has node scope. |
| boolean | [isMCOrgLocal](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#isMCOrgLocal())() Utility routine to check if the multicast address has organization scope. |
| boolean | [isMCSiteLocal](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#isMCSiteLocal())() Utility routine to check if the multicast address has site scope. |
| boolean | [isMulticastAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#isMulticastAddress())() Utility routine to check if the InetAddress is an IP multicast address. |
| boolean | [isReachable](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#isReachable(int))(int timeout) Test whether that address is reachable. |
| boolean | [isReachable](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#isReachable(java.net.NetworkInterface,%20int,%20int))([NetworkInterface](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/NetworkInterface.html) netif, int ttl, int timeout) Test whether that address is reachable. |
| boolean | [isSiteLocalAddress](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#isSiteLocalAddress())() Utility routine to check if the InetAddress is a site local address. |
| [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) | [toString](https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#toString())() Converts this IP address to a `String`. |

From class [java.lang.Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html)

|---|---|
| [Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) | [clone](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#clone())() Creates and returns a copy of this `Object`. |
| boolean | [equals](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#equals(java.lang.Object))([Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) obj) Compares this instance with the specified object and indicates if they are equal. |
| void | [finalize](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#finalize())() Invoked when the garbage collector has detected that this instance is no longer reachable. |
| final [Class](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Class.html)\<?\> | [getClass](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#getClass())() Returns the unique instance of `https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Class.html` that represents this object's class. |
| int | [hashCode](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#hashCode())() Returns an integer hash code for this object. |
| final void | [notify](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#notify())() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up. |
| final void | [notifyAll](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#notifyAll())() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up. |
| [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) | [toString](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#toString())() Returns a string containing a concise, human-readable description of this object. |
| final void | [wait](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait(long,%20int))(long timeout, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires. |
| final void | [wait](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait(long))(long timeout) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires. |
| final void | [wait](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait())() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object. |

## Public Methods

#### public boolean
**equals**
([Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) obj)

Compares this object against the specified object.
The result is `true` if and only if the argument is
not `null` and it represents the same IP address as
this object.


Two instances of `InetAddress` represent the same IP
address if the length of the byte arrays returned by
`getAddress` is the same for both, and each of the
array components is the same for the byte arrays.

##### Parameters

| obj | the object to compare against. |
|---|---|

##### Returns

- `true` if the objects are the same; `false` otherwise.

##### See Also

- `https://developers.google.com/j2objc/javadoc/jre/reference/java/net/InetAddress.html#getAddress()`

#### public byte\[\]
**getAddress**
()

Returns the raw IP address of this `InetAddress`
object. The result is in network byte order: the highest order
byte of the address is in `getAddress()[0]`.

##### Returns

- the raw IP address of this object.

#### public [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html)
**getHostAddress**
()

Returns the IP address string in textual presentation form.

##### Returns

- the raw IP address in a string format.

#### public int
**hashCode**
()

Returns a hashcode for this IP address.

##### Returns

- a hash code value for this IP address.

#### public boolean
**isAnyLocalAddress**
()

Utility routine to check if the InetAddress in a wildcard address.

##### Returns

- a `boolean` indicating if the Inetaddress is a wildcard address.

#### public boolean
**isLinkLocalAddress**
()

Utility routine to check if the InetAddress is an link local address.

##### Returns

- a `boolean` indicating if the InetAddress is a link local address; or false if address is not a link local unicast address.

#### public boolean
**isLoopbackAddress**
()

Utility routine to check if the InetAddress is a loopback address.

##### Returns

- a `boolean` indicating if the InetAddress is a loopback address; or false otherwise.

#### public boolean
**isMCGlobal**
()

Utility routine to check if the multicast address has global scope.

##### Returns

- a `boolean` indicating if the address has is a multicast address of global scope, false if it is not of global scope or it is not a multicast address

#### public boolean
**isMCLinkLocal**
()

Utility routine to check if the multicast address has link scope.

##### Returns

- a `boolean` indicating if the address has is a multicast address of link-local scope, false if it is not of link-local scope or it is not a multicast address

#### public boolean
**isMCNodeLocal**
()

Utility routine to check if the multicast address has node scope.

##### Returns

- a `boolean` indicating if the address has is a multicast address of node-local scope, false if it is not of node-local scope or it is not a multicast address

#### public boolean
**isMCOrgLocal**
()

Utility routine to check if the multicast address has organization scope.

##### Returns

- a `boolean` indicating if the address has is a multicast address of organization-local scope, false if it is not of organization-local scope or it is not a multicast address

#### public boolean
**isMCSiteLocal**
()

Utility routine to check if the multicast address has site scope.

##### Returns

- a `boolean` indicating if the address has is a multicast address of site-local scope, false if it is not of site-local scope or it is not a multicast address

#### public boolean
**isMulticastAddress**
()

Utility routine to check if the InetAddress is an
IP multicast address. IP multicast address is a Class D
address i.e first four bits of the address are 1110.

##### Returns

- a `boolean` indicating if the InetAddress is an IP multicast address

#### public boolean
**isSiteLocalAddress**
()

Utility routine to check if the InetAddress is a site local address.

##### Returns

- a `boolean` indicating if the InetAddress is a site local address; or false if address is not a site local unicast address.