< prev index next >
src/java.base/share/classes/java/net/Inet6Address.java
Print this page
*** 47,59 ****
* <li><p> <a id="lform">The preferred form</a> is x:x:x:x:x:x:x:x,
* where the 'x's are
* the hexadecimal values of the eight 16-bit pieces of the
* address. This is the full form. For example,
*
! * <blockquote><table cellpadding=0 cellspacing=0 summary="layout">
! * <tr><td>{@code 1080:0:0:0:8:800:200C:417A}<td></tr>
! * </table></blockquote>
*
* <p> Note that it is not necessary to write the leading zeros in
* an individual field. However, there must be at least one numeral
* in every field, except as described below.</li>
*
--- 47,59 ----
* <li><p> <a id="lform">The preferred form</a> is x:x:x:x:x:x:x:x,
* where the 'x's are
* the hexadecimal values of the eight 16-bit pieces of the
* address. This is the full form. For example,
*
! * <blockquote><ul style="list-style-type:none">
! * <li>{@code 1080:0:0:0:8:800:200C:417A}</li>
! * </ul></blockquote>
*
* <p> Note that it is not necessary to write the leading zeros in
* an individual field. However, there must be at least one numeral
* in every field, except as described below.</li>
*
*** 64,113 ****
* compress the zeros. The use of "::" indicates multiple groups
* of 16-bits of zeros. The "::" can only appear once in an address.
* The "::" can also be used to compress the leading and/or trailing
* zeros in an address. For example,
*
! * <blockquote><table cellpadding=0 cellspacing=0 summary="layout">
! * <tr><td>{@code 1080::8:800:200C:417A}<td></tr>
! * </table></blockquote>
*
* <li><p> An alternative form that is sometimes more convenient
* when dealing with a mixed environment of IPv4 and IPv6 nodes is
* x:x:x:x:x:x:d.d.d.d, where the 'x's are the hexadecimal values
* of the six high-order 16-bit pieces of the address, and the 'd's
* are the decimal values of the four low-order 8-bit pieces of the
* standard IPv4 representation address, for example,
*
! * <blockquote><table cellpadding=0 cellspacing=0 summary="layout">
! * <tr><td>{@code ::FFFF:129.144.52.38}<td></tr>
! * <tr><td>{@code ::129.144.52.38}<td></tr>
! * </table></blockquote>
*
* <p> where "::FFFF:d.d.d.d" and "::d.d.d.d" are, respectively, the
* general forms of an IPv4-mapped IPv6 address and an
* IPv4-compatible IPv6 address. Note that the IPv4 portion must be
* in the "d.d.d.d" form. The following forms are invalid:
*
! * <blockquote><table cellpadding=0 cellspacing=0 summary="layout">
! * <tr><td>{@code ::FFFF:d.d.d}<td></tr>
! * <tr><td>{@code ::FFFF:d.d}<td></tr>
! * <tr><td>{@code ::d.d.d}<td></tr>
! * <tr><td>{@code ::d.d}<td></tr>
! * </table></blockquote>
*
* <p> The following form:
*
! * <blockquote><table cellpadding=0 cellspacing=0 summary="layout">
! * <tr><td>{@code ::FFFF:d}<td></tr>
! * </table></blockquote>
*
* <p> is valid, however it is an unconventional representation of
* the IPv4-compatible IPv6 address,
*
! * <blockquote><table cellpadding=0 cellspacing=0 summary="layout">
! * <tr><td>{@code ::255.255.0.d}<td></tr>
! * </table></blockquote>
*
* <p> while "::d" corresponds to the general IPv6 address
* "0:0:0:0:0:0:0:d".</li>
* </ol>
*
--- 64,113 ----
* compress the zeros. The use of "::" indicates multiple groups
* of 16-bits of zeros. The "::" can only appear once in an address.
* The "::" can also be used to compress the leading and/or trailing
* zeros in an address. For example,
*
! * <blockquote><ul style="list-style-type:none">
! * <li>{@code 1080::8:800:200C:417A}</li>
! * </ul></blockquote>
*
* <li><p> An alternative form that is sometimes more convenient
* when dealing with a mixed environment of IPv4 and IPv6 nodes is
* x:x:x:x:x:x:d.d.d.d, where the 'x's are the hexadecimal values
* of the six high-order 16-bit pieces of the address, and the 'd's
* are the decimal values of the four low-order 8-bit pieces of the
* standard IPv4 representation address, for example,
*
! * <blockquote><ul style="list-style-type:none">
! * <li>{@code ::FFFF:129.144.52.38}</li>
! * <li>{@code ::129.144.52.38}</li>
! * </ul></blockquote>
*
* <p> where "::FFFF:d.d.d.d" and "::d.d.d.d" are, respectively, the
* general forms of an IPv4-mapped IPv6 address and an
* IPv4-compatible IPv6 address. Note that the IPv4 portion must be
* in the "d.d.d.d" form. The following forms are invalid:
*
! * <blockquote><ul style="list-style-type:none">
! * <li>{@code ::FFFF:d.d.d}</li>
! * <li>{@code ::FFFF:d.d}</li>
! * <li>{@code ::d.d.d}</li>
! * <li>{@code ::d.d}</li>
! * </ul></blockquote>
*
* <p> The following form:
*
! * <blockquote><ul style="list-style-type:none">
! * <li>{@code ::FFFF:d}</li>
! * </ul></blockquote>
*
* <p> is valid, however it is an unconventional representation of
* the IPv4-compatible IPv6 address,
*
! * <blockquote><ul style="list-style-type:none">
! * <li>{@code ::255.255.0.d}</li>
! * </ul></blockquote>
*
* <p> while "::d" corresponds to the general IPv6 address
* "0:0:0:0:0:0:0:d".</li>
* </ol>
*
*** 117,129 ****
* textual data.
*
* <h4> Special IPv6 address </h4>
*
* <blockquote>
! * <table cellspacing=2 summary="Description of IPv4-mapped address">
! * <tr><th valign=top><i>IPv4-mapped address</i></th>
! * <td>Of the form::ffff:w.x.y.z, this IPv6 address is used to
* represent an IPv4 address. It allows the native program to
* use the same address data structure and also the same
* socket when communicating with both IPv4 and IPv6 nodes.
*
* <p>In InetAddress and Inet6Address, it is used for internal
--- 117,130 ----
* textual data.
*
* <h4> Special IPv6 address </h4>
*
* <blockquote>
! * <table>
! * <caption style="display:none">Description of IPv4-mapped address</caption>
! * <tr><th style="vertical-align:top; padding-right:2px"><i>IPv4-mapped address</i></th>
! * <td>Of the form ::ffff:w.x.y.z, this IPv6 address is used to
* represent an IPv4 address. It allows the native program to
* use the same address data structure and also the same
* socket when communicating with both IPv4 and IPv6 nodes.
*
* <p>In InetAddress and Inet6Address, it is used for internal
< prev index next >