Skip to content

Commit 874d236

Browse files
j2objc-copybaracopybara-github
authored andcommitted
Update java.nio.charset package to android13 release
#J2ObjC_Android13_JRE_Upgrade_2022 PiperOrigin-RevId: 505795936
1 parent f2df087 commit 874d236

1 file changed

Lines changed: 53 additions & 42 deletions

File tree

  • jre_emul/android/platform/libcore/ojluni/src/main/java/java/nio/charset

jre_emul/android/platform/libcore/ojluni/src/main/java/java/nio/charset/package-info.java

Lines changed: 53 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -24,61 +24,72 @@
2424
*/
2525

2626
/**
27-
* Defines charsets, decoders, and encoders, for translating between bytes and
28-
* Unicode characters.
27+
* Defines charsets, decoders, and encoders, for translating between
28+
* bytes and Unicode characters.
2929
*
30-
* <blockquote><table cellspacing=1 cellpadding=0 summary="Summary of charsets, decoders, and encoders in this package">
31-
* <tr><th><p align="left">Class name</p></th><th><p align="left">Description</p></th></tr>
32-
* <tr><td valign=top><tt>{@link java.nio.charset.Charset}</tt></td>
33-
* <td>A named mapping between characters<br>and bytes</td></tr>
34-
* <tr><td valign=top><tt>{@link java.nio.charset.CharsetDecoder}</tt></td>
30+
* <table class="striped" style="margin-left:2em; text-align:left">
31+
* <caption style="display:none">Summary of charsets, decoders, and encoders in this package</caption>
32+
* <thead>
33+
* <tr><th scope="col">Class name</th>
34+
* <th scope="col">Description
35+
* </thead>
36+
* <tbody>
37+
* <tr><th scope="row">{@link java.nio.charset.Charset}</th>
38+
* <td>A named mapping between characters and bytes</td></tr>
39+
* <tr><th scope="row">{@link java.nio.charset.CharsetDecoder}</th>
3540
* <td>Decodes bytes into characters</td></tr>
36-
* <tr><td valign=top><tt>{@link java.nio.charset.CharsetEncoder}&nbsp;&nbsp;</tt></td>
41+
* <tr><th scope="row">{@link java.nio.charset.CharsetEncoder}</th>
3742
* <td>Encodes characters into bytes</td></tr>
38-
* <tr><td valign=top><tt>{@link java.nio.charset.CoderResult}&nbsp;&nbsp;</tt></td>
43+
* <tr><th scope="row">{@link java.nio.charset.CoderResult}</th>
3944
* <td>Describes coder results</td></tr>
40-
* <tr><td valign=top><tt>{@link java.nio.charset.CodingErrorAction}&nbsp;&nbsp;</tt></td>
41-
* <td>Describes actions to take when<br>coding errors are detected</td></tr>
45+
* <tr><th scope="row">{@link java.nio.charset.CodingErrorAction}</th>
46+
* <td>Describes actions to take when coding errors are detected</td></tr>
47+
* </tbody>
48+
* </table>
4249
*
43-
* </table></blockquote>
50+
* <p> A <i>charset</i> is named mapping between sequences of
51+
* sixteen-bit Unicode characters and sequences of bytes, in the sense
52+
* defined in <a
53+
* href="http://www.ietf.org/rfc/rfc2278.txt"><i>RFC&nbsp;2278</i></a>.
54+
* A <i>decoder</i> is an engine which transforms bytes in a specific
55+
* charset into characters, and an <i>encoder</i> is an engine which
56+
* transforms characters into bytes. Encoders and decoders operate on
57+
* byte and character buffers. They are collectively referred to as
58+
* <i>coders</i>.
4459
*
45-
* <p> A <i>charset</i> is named mapping between sequences of sixteen-bit Unicode
46-
* characters and sequences of bytes, in the sense defined in <a
47-
* href="http://www.ietf.org/rfc/rfc2278.txt"><i>RFC&nbsp;2278</i></a>. A
48-
* <i>decoder</i> is an engine which transforms bytes in a specific charset into
49-
* characters, and an <i>encoder</i> is an engine which transforms characters into
50-
* bytes. Encoders and decoders operate on byte and character buffers. They are
51-
* collectively referred to as <i>coders</i>.
60+
* <p> The {@link java.nio.charset.Charset} class defines methods for
61+
* creating coders for a given charset and for retrieving the various
62+
* names associated with a charset. It also defines static methods
63+
* for testing whether a particular charset is supported, for locating
64+
* charset instances by name, and for constructing a map that contains
65+
* every charset for which support is available in the current Java
66+
* virtual machine.
5267
*
53-
* <p> The {@link java.nio.charset.Charset} class defines methods for creating
54-
* coders for a given charset and for retrieving the various names associated with
55-
* a charset. It also defines static methods for testing whether a particular
56-
* charset is supported, for locating charset instances by name, and for
57-
* constructing a map that contains every charset for which support is available
58-
* in the current Java virtual machine.
68+
* <p> Most users will not use these classes directly; instead they
69+
* will use the existing charset-related constructors and methods in
70+
* the {@link java.lang.String} class, together with the existing
71+
* {@link java.io.InputStreamReader} and {@link
72+
* java.io.OutputStreamWriter} classes, all of whose implementations
73+
* have been reworked to make use of the charset facilities defined in
74+
* this package. A small number of changes have been made to the
75+
* {@link java.io.InputStreamReader} and {@link
76+
* java.io.OutputStreamWriter} classes in order to allow explicit
77+
* charset objects to be specified in the construction of instances of
78+
* those classes.
5979
*
60-
* <p> Most users will not use these classes directly; instead they will use the
61-
* existing charset-related constructors and methods in the {@link
62-
* java.lang.String} class, together with the existing {@link
63-
* java.io.InputStreamReader} and {@link java.io.OutputStreamWriter} classes, all
64-
* of whose implementations have been reworked to make use of the charset
65-
* facilities defined in this package. A small number of changes have been made
66-
* to the {@link java.io.InputStreamReader} and {@link java.io.OutputStreamWriter}
67-
* classes in order to allow explicit charset objects to be specified in the
68-
* construction of instances of those classes.
80+
* <p> Support for new charsets can be made available via the
81+
* interface defined in the {@link
82+
* java.nio.charset.spi.CharsetProvider} class in the {@link
83+
* java.nio.charset.spi} package.
6984
*
70-
* <p> Support for new charsets can be made available via the interface defined in
71-
* the {@link java.nio.charset.spi.CharsetProvider} class in the <tt>{@link
72-
* java.nio.charset.spi}</tt> package.
73-
*
74-
* <p> Unless otherwise noted, passing a <tt>null</tt> argument to a constructor
75-
* or method in any class or interface in this package will cause a {@link
76-
* java.lang.NullPointerException NullPointerException} to be thrown.
85+
* <p> Unless otherwise noted, passing a {@code null} argument to a
86+
* constructor or method in any class or interface in this package
87+
* will cause a {@link java.lang.NullPointerException
88+
* NullPointerException} to be thrown.
7789
*
7890
*
7991
* @since 1.4
8092
* @author Mark Reinhold
8193
* @author JSR-51 Expert Group
8294
*/
83-
8495
package java.nio.charset;

0 commit comments

Comments
 (0)