軟體套件 java.nio.charset

定義用來在位元組和 Unicode 字元之間轉換的 charset、解碼器和編碼器。

請參見：
描述

類別摘要

Charset	16 位的 Unicode 程式碼單元序列和位元組序列之間的指定映射關係。
CharsetDecoder	能夠把特定 charset 中的位元組序列轉換成 16 位 Unicode 字元序列的引擎。
CharsetEncoder	能夠把 16 位 Unicode 字元序列轉換成特定 charset 中位元組序列的引擎。
CoderResult	coder 結果狀態的描述。
CodingErrorAction	編碼錯誤操作的型別安全的列舉。

異常摘要

CharacterCodingException	出現字元編碼或解碼錯誤時，拋出此經過檢查的異常。
IllegalCharsetNameException	將一個不是合法 charset 名稱的字元串用作 charset 名稱時，拋出此未經檢查的異常。
MalformedInputException	當輸入位元組序列對於給定 charset 來說是不合法的，或者輸入字元序列不是合法的 16 位 Unicode 序列時，拋出此經過檢查的異常。
UnmappableCharacterException	當輸入字元（或位元組）序列有效，但不能被映射為輸出位元組（或字元）序列時，拋出此經過檢查的異常。
UnsupportedCharsetException	當不支持請求的 charset 時，拋出此未經檢查的異常。

錯誤摘要

CoderMalfunctionError

當 CharsetDecoder 的 decodeLoop 方法，或 CharsetEncoder 的 encodeLoop 方法拋出不可預料的異常時拋出的錯誤。

軟體套件 java.nio.charset 的描述

定義用來在位元組和 Unicode 字元之間轉換的 charset、解碼器和編碼器。

類別名	描述
Charset	字元和位元組之間的指定映射關係
CharsetDecoder	把位元組解碼為字元
CharsetEncoder	把字元編碼為位元組
CoderResult	描述 coder 的結果
CodingErrorAction	描述檢測到編碼錯誤時所採取的操作

charset 是 16 位 Unicode 字元序列和位元組序列之間的指定映射關係，從某種意義上來說，在 RFC 2278 中對其進行了定義。解碼器 是把一個特定 charset 中的位元組轉換成字元的引擎，編碼器 是把字元轉換成位元組的引擎。編碼器和解碼器在位元組和字元緩衝區上操作。它們共同被稱為 coder。

Charset 類別定義了為給定的 charset 創建 coder 的方法和獲取與某個 charset 相關的名稱的方法。它還定義了用於測試是否支持特定 charset 的靜態方法、通過名稱尋找 charset 實例的靜態方法，以及建構一個套件含目前 Java 虛擬機器支持的每個 charset 的映射靜態方法。

大多數使用者不直接使用這些類別；他們使用 String 類別中存在的和 charset 有關的建構子和方法，一起使用的還有 InputStreamReader 和 OutputStreamWriter 類別，為了利用此套件中定義的 charset 設施，所有這些類別的實作都被覆寫。為了在建構這些類別的實例時顯式地指定 charset 物件，已經對 InputStreamReader 和 OutputStreamWriter 類別做了一些更改。

通過在 java.nio.charset.spi 套件中的 CharsetProvider 類別中定義的介面，可提供對新 charset 的支持。

除非另行說明，否則將 null 參數傳遞給此套件中任何類別或介面的建構子或方法將會導致拋出 NullPointerException。

從以下版本開始：

1.4