A named mapping between sequences of sixteen-bit Unicode code units and sequences of bytes.
An engine that can transform a sequence of bytes in a specific charset into a sequence of sixteen-bit Unicode characters.
An engine that can transform a sequence of sixteen-bit Unicode characters into a sequence of bytes in a specific charset.
A description of the result state of a coder.
A typesafe enumeration for coding-error actions.
Constant definitions for the standard
Checked exception thrown when a character encoding or decoding error occurs.
Unchecked exception thrown when a string that is not a legal charset name is used as such.
Checked exception thrown when an input byte sequence is not legal for given charset, or an input character sequence is not a legal sixteen-bit Unicode sequence.
Checked exception thrown when an input character (or byte) sequence is valid but cannot be mapped to an output byte (or character) sequence.
Unchecked exception thrown when no support is available for a requested charset.
A named mapping between characters
Decodes bytes into characters
Encodes characters into bytes
Describes coder results
Describes actions to take when
coding errors are detected
A charset is named mapping between sequences of sixteen-bit Unicode characters and sequences of bytes, in the sense defined in RFC 2278. A decoder is an engine which transforms bytes in a specific charset into characters, and an encoder is an engine which transforms characters into bytes. Encoders and decoders operate on byte and character buffers. They are collectively referred to as coders.
Charset class defines methods for creating
coders for a given charset and for retrieving the various names associated with
a charset. It also defines static methods for testing whether a particular
charset is supported, for locating charset instances by name, and for
constructing a map that contains every charset for which support is available
in the current Java virtual machine.
Most users will not use these classes directly; instead they will use the
existing charset-related constructors and methods in the
String class, together with the existing
OutputStreamWriter classes, all
of whose implementations have been reworked to make use of the charset
facilities defined in this package. A small number of changes have been made
classes in order to allow explicit charset objects to be specified in the
construction of instances of those classes.
Unless otherwise noted, passing a null argument to a constructor
or method in any class or interface in this package will cause a
NullPointerException to be thrown.
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.