src/java.base/share/classes/java/net/Inet6Address.java
changeset 54206 003cc64366da
parent 53018 8bf9268df0e2
child 55375 96c7427456f9
child 58678 9cf78a70fa4f
equal deleted inserted replaced
54205:d9f43dfbe524 54206:003cc64366da
     1 /*
     1 /*
     2  * Copyright (c) 2000, 2018, Oracle and/or its affiliates. All rights reserved.
     2  * Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     4  *
     4  *
     5  * This code is free software; you can redistribute it and/or modify it
     5  * This code is free software; you can redistribute it and/or modify it
     6  * under the terms of the GNU General Public License version 2 only, as
     6  * under the terms of the GNU General Public License version 2 only, as
     7  * published by the Free Software Foundation.  Oracle designates this
     7  * published by the Free Software Foundation.  Oracle designates this
    36 /**
    36 /**
    37  * This class represents an Internet Protocol version 6 (IPv6) address.
    37  * This class represents an Internet Protocol version 6 (IPv6) address.
    38  * Defined by <a href="http://www.ietf.org/rfc/rfc2373.txt">
    38  * Defined by <a href="http://www.ietf.org/rfc/rfc2373.txt">
    39  * <i>RFC&nbsp;2373: IP Version 6 Addressing Architecture</i></a>.
    39  * <i>RFC&nbsp;2373: IP Version 6 Addressing Architecture</i></a>.
    40  *
    40  *
    41  * <h3> <a id="format">Textual representation of IP addresses</a> </h3>
    41  * <h2> <a id="format">Textual representation of IP addresses</a> </h2>
    42  *
    42  *
    43  * Textual representation of IPv6 address used as input to methods
    43  * Textual representation of IPv6 address used as input to methods
    44  * takes one of the following forms:
    44  * takes one of the following forms:
    45  *
    45  *
    46  * <ol>
    46  * <ol>
   114  * <p> For methods that return a textual representation as output
   114  * <p> For methods that return a textual representation as output
   115  * value, the full form is used. Inet6Address will return the full
   115  * value, the full form is used. Inet6Address will return the full
   116  * form because it is unambiguous when used in combination with other
   116  * form because it is unambiguous when used in combination with other
   117  * textual data.
   117  * textual data.
   118  *
   118  *
   119  * <h4> Special IPv6 address </h4>
   119  * <h3> Special IPv6 address </h3>
   120  *
   120  *
   121  * <blockquote>
   121  * <blockquote>
   122  * <table class="borderless">
   122  * <table class="borderless">
   123  * <caption style="display:none">Description of IPv4-mapped address</caption>
   123  * <caption style="display:none">Description of IPv4-mapped address</caption>
   124  * <tr><th style="vertical-align:top; padding-right:2px"><i>IPv4-mapped address</i></th>
   124  * <tr><th style="vertical-align:top; padding-right:2px"><i>IPv4-mapped address</i></th>
   133  *         IPv4-mapped address as input, both in byte array and text
   133  *         IPv4-mapped address as input, both in byte array and text
   134  *         representation. However, it will be converted into an IPv4
   134  *         representation. However, it will be converted into an IPv4
   135  *         address.</td></tr>
   135  *         address.</td></tr>
   136  * </table></blockquote>
   136  * </table></blockquote>
   137  *
   137  *
   138  * <h4><a id="scoped">Textual representation of IPv6 scoped addresses</a></h4>
   138  * <h3><a id="scoped">Textual representation of IPv6 scoped addresses</a></h3>
   139  *
   139  *
   140  * <p> The textual representation of IPv6 addresses as described above can be
   140  * <p> The textual representation of IPv6 addresses as described above can be
   141  * extended to specify IPv6 scoped addresses. This extension to the basic
   141  * extended to specify IPv6 scoped addresses. This extension to the basic
   142  * addressing architecture is described in [draft-ietf-ipngwg-scoping-arch-04.txt].
   142  * addressing architecture is described in [draft-ietf-ipngwg-scoping-arch-04.txt].
   143  *
   143  *