src/java.base/share/classes/java/nio/charset/Charset.java
changeset 55016 4f98fcd1bf16
parent 49556 809b178407cc
equal deleted inserted replaced
55015:738285c4d1e1 55016:4f98fcd1bf16
     1 /*
     1 /*
     2  * Copyright (c) 2000, 2017, 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
    65  *
    65  *
    66  * <p> All of the methods defined in this class are safe for use by multiple
    66  * <p> All of the methods defined in this class are safe for use by multiple
    67  * concurrent threads.
    67  * concurrent threads.
    68  *
    68  *
    69  *
    69  *
    70  * <a id="names"></a><a id="charenc"></a>
    70  * <h2><a id="names">Charset names</a></h2>
    71  * <h2>Charset names</h2>
       
    72  *
    71  *
    73  * <p> Charsets are named by strings composed of the following characters:
    72  * <p> Charsets are named by strings composed of the following characters:
    74  *
    73  *
    75  * <ul>
    74  * <ul>
    76  *
    75  *
   136  * ensure compatibility it is recommended that no alias ever be removed from a
   135  * ensure compatibility it is recommended that no alias ever be removed from a
   137  * charset, and that if the canonical name of a charset is changed then its
   136  * charset, and that if the canonical name of a charset is changed then its
   138  * previous canonical name be made into an alias.
   137  * previous canonical name be made into an alias.
   139  *
   138  *
   140  *
   139  *
   141  * <h2>Standard charsets</h2>
   140  * <h2><a id="standard">Standard charsets</a></h2>
   142  *
   141  *
   143  *
   142  *
   144  *
   143  * <p> Every implementation of the Java platform is required to support the
   145  * <p><a id="standard">Every implementation of the Java platform is required to support the
   144  * following standard charsets.  Consult the release documentation for your
   146  * following standard charsets.</a>  Consult the release documentation for your
       
   147  * implementation to see if any other charsets are supported.  The behavior
   145  * implementation to see if any other charsets are supported.  The behavior
   148  * of such optional charsets may differ between implementations.
   146  * of such optional charsets may differ between implementations.
   149  *
   147  *
   150  * <blockquote><table class="striped" style="width:80%">
   148  * <blockquote><table class="striped" style="width:80%">
   151  * <caption style="display:none">Description of standard charsets</caption>
   149  * <caption style="display:none">Description of standard charsets</caption>
   215  * <p> Every instance of the Java virtual machine has a default charset, which
   213  * <p> Every instance of the Java virtual machine has a default charset, which
   216  * may or may not be one of the standard charsets.  The default charset is
   214  * may or may not be one of the standard charsets.  The default charset is
   217  * determined during virtual-machine startup and typically depends upon the
   215  * determined during virtual-machine startup and typically depends upon the
   218  * locale and charset being used by the underlying operating system. </p>
   216  * locale and charset being used by the underlying operating system. </p>
   219  *
   217  *
   220  * <p>The {@link StandardCharsets} class defines constants for each of the
   218  * <p> The {@link StandardCharsets} class defines constants for each of the
   221  * standard charsets.
   219  * standard charsets.
   222  *
   220  *
   223  * <h2>Terminology</h2>
   221  * <h2>Terminology</h2>
   224  *
   222  *
   225  * <p> The name of this class is taken from the terms used in
   223  * <p> The name of this class is taken from the terms used in