1 /* |
1 /* |
2 * Copyright (c) 2001, 2010, Oracle and/or its affiliates. All rights reserved. |
2 * Copyright (c) 2001, 2017, 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 |
25 |
25 |
26 /** |
26 /** |
27 * Defines charsets, decoders, and encoders, for translating between |
27 * Defines charsets, decoders, and encoders, for translating between |
28 * bytes and Unicode characters. |
28 * bytes and Unicode characters. |
29 * |
29 * |
30 * <blockquote><table class="borderless"> |
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> |
31 * <caption style="display:none">Summary of charsets, decoders, and encoders in this package</caption> |
32 * <tr><th style="text-align:left">Class name</th> |
32 * <thead> |
33 * <th style="text-align:left"><th>DescriptiPath |
33 * <tr><th scope="col">Class name</th> |
34 * <tr><td style="vertical-align:top">{@link java.nio.charset.Charset}</td> |
34 * <th scope="col">Description |
35 * <td>A named mapping between characters<br>and bytes</td></tr> |
35 * </thead> |
36 * <tr><td style="vertical-align:top">{@link java.nio.charset.CharsetDecoder}</td> |
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> |
37 * <td>Decodes bytes into characters</td></tr> |
40 * <td>Decodes bytes into characters</td></tr> |
38 * <tr><td style="vertical-align:top">{@link java.nio.charset.CharsetEncoder}</td> |
41 * <tr><th scope="row">{@link java.nio.charset.CharsetEncoder}</th> |
39 * <td>Encodes characters into bytes</td></tr> |
42 * <td>Encodes characters into bytes</td></tr> |
40 * <tr><td style="vertical-align:top">{@link java.nio.charset.CoderResult}</td> |
43 * <tr><th scope="row">{@link java.nio.charset.CoderResult}</th> |
41 * <td>Describes coder results</td></tr> |
44 * <td>Describes coder results</td></tr> |
42 * <tr><td style="vertical-align:top">{@link java.nio.charset.CodingErrorAction}</td> |
45 * <tr><th scope="row">{@link java.nio.charset.CodingErrorAction}</th> |
43 * <td>Describes actions to take when<br>coding errors are detected</td></tr> |
46 * <td>Describes actions to take when coding errors are detected</td></tr> |
44 * |
47 * </tbody> |
45 * </table></blockquote> |
48 * </table> |
46 * |
49 * |
47 * <p> A <i>charset</i> is named mapping between sequences of |
50 * <p> A <i>charset</i> is named mapping between sequences of |
48 * sixteen-bit Unicode characters and sequences of bytes, in the sense |
51 * sixteen-bit Unicode characters and sequences of bytes, in the sense |
49 * defined in <a |
52 * defined in <a |
50 * href="http://www.ietf.org/rfc/rfc2278.txt"><i>RFC 2278</i></a>. |
53 * href="http://www.ietf.org/rfc/rfc2278.txt"><i>RFC 2278</i></a>. |