Module java.base

Package java.nio.charset

package java.nio.charset

定义了用于在字节和Unicode字符之间进行转换的字符集、解码器和编码器。

此包中字符集、解码器和编码器的摘要

类名	描述
Charset	字符和字节之间的命名映射
CharsetDecoder	将字节解码为字符
CharsetEncoder	将字符编码为字节
CoderResult	描述编码器结果
CodingErrorAction	描述在检测到编码错误时要采取的操作

字符集是十六位Unicode字符序列和字节序列之间的命名映射，其定义如RFC 2278中所述。 解码器是将特定字符集中的字节转换为字符的引擎，而 编码器是将字符转换为字节的引擎。编码器和解码器操作字节和字符缓冲区。它们统称为 编码器。

Charset类定义了用于为给定字符集创建编码器以及检索与字符集关联的各种名称的方法。它还定义了用于测试特定字符集是否受支持、通过名称查找字符集实例以及构建包含当前Java虚拟机中可用支持的每个字符集的映射的静态方法。

大多数用户不会直接使用这些类；相反，他们将使用 String类中现有的与字符集相关的构造函数和方法，以及已重新设计以利用此包中定义的字符集功能的现有 InputStreamReader 和 OutputStreamWriter 类的所有实现。为了允许在构造这些类的实例时指定显式字符集对象，对 InputStreamReader 和 OutputStreamWriter 类进行了少量更改。

通过在 CharsetProvider类中定义的接口，可以通过新的字符集提供支持。

除非另有说明，在此包中的任何类或接口的构造函数或方法中传递 null 参数将导致抛出 NullPointerException。

自版本:

1.4

外部规范

• RFC 2278: IANA字符集注册程序

Related Packages

Package	Description
java.nio	定义了数据容器——缓冲区，并提供了其他NIO包的概述。
java.nio.charset.spi	用于 java.nio.charset 包的服务提供程序类。
java.nio.channels	定义了通道，表示能够执行I/O操作的实体的连接，如文件和套接字；定义了选择器，用于多路复用的非阻塞I/O操作。
java.nio.file	为Java虚拟机访问文件、文件属性和文件系统定义了接口和类。

Class	Description
CharacterCodingException	当发生字符编码或解码错误时抛出的已检查异常。
Charset	十六位Unicode 代码单元序列和字节序列之间的命名映射。
CharsetDecoder	可以将特定字符集中的字节序列转换为十六位Unicode字符序列的引擎。
CharsetEncoder	可以将十六位Unicode字符序列转换为特定字符集中的字节序列的引擎。
CoderMalfunctionError	当 decodeLoop 方法的 CharsetDecoder，或者 encodeLoop 方法的 CharsetEncoder 抛出意外异常时抛出的错误。
CoderResult	编码器结果状态的描述。
CodingErrorAction	用于编码错误操作的类型安全枚举。
IllegalCharsetNameException	当将不是 合法字符集名称 的字符串用作此类时抛出的未检查异常。
MalformedInputException	当输入字节序列对于给定字符集不合法，或者输入字符序列不是合法的十六位Unicode序列时抛出的已检查异常。
StandardCharsets	标准 字符集 的常量定义。
UnmappableCharacterException	当输入字符（或字节）序列有效但无法映射到输出字节（或字符）序列时抛出的已检查异常。
UnsupportedCharsetException	当请求的字符集不受支持时抛出的未检查异常。