パッケージ java.nio.charset

バイトと Unicode 文字の相互変換を行うため、文字セット、デコーダ、およびエンコーダを定義します。

参照:
説明

クラスの概要

Charset	16 ビット Unicode 文字のシーケンスとバイトシーケンス間の指定マップです。
CharsetDecoder	特定の文字セットで表現されたバイトシーケンスを 16 ビット Unicode 文字のシーケンスに変換するエンジンです。
CharsetEncoder	16 ビット Unicode 文字のシーケンスを特定の文字セットで表現されたバイトシーケンスに変換するエンジンです。
CoderResult	コーダの結果状態の説明です。
CodingErrorAction	コーディングエラーが発生したときに実行するアクションの型保証された列挙です。

例外の概要

CharacterCodingException	文字のエンコードエラーやデコードエラーが発生したときにスローされるチェック例外です。
IllegalCharsetNameException	ある文字列が、正当な文字セット名ではないのに正当であるかのように使用された場合にスローされるチェックされない例外です。
MalformedInputException	入力バイトシーケンスが指定文字セットにとって正当でない場合、または入力文字シーケンスが 16 ビットの正規 Unicode シーケンスでない場合にスローされるチェック例外です。
UnmappableCharacterException	入力文字 (またはバイト) シーケンスは有効だが出力バイト (または文字) シーケンスにマップできない場合にスローされるチェック例外です。
UnsupportedCharsetException	要求された文字セットがサポートされない場合にスローされるチェックされない例外です。

エラーの概要

CoderMalfunctionError

CharsetDecoder の decodeLoop メソッドや CharsetEncoder の encodeLoop メソッドが予想外の例外をスローするときスローされるエラーです。

パッケージ java.nio.charset の説明

バイトと Unicode 文字の相互変換を行うため、文字セット、デコーダ、およびエンコーダを定義します。

Charset	文字とバイト間の指定されたマッピング
CharsetDecoder	バイトから文字へのデコード
CharsetEncoder	文字からバイトへのエンコード
CoderResult	コーダの結果の説明
CodingErrorAction	コーディングエラーが検出されたときに実行するアクションの説明

「文字セット」は、RFC 2278 に定義されている、16 ビット Unicode 文字シーケンスとバイトシーケンス間の指定されたマッピングです。「デコーダ」は、特定の文字セットで表現されたバイトを文字に変換するエンジンです。「エンコーダ」は、文字をバイトに変換するエンジンです。エンコーダとデコーダは、byte バッファや char バッファを操作します。これらをまとめて「コーダ」と呼びます。

Charset クラスは、指定された文字セット用のコーダを作成するメソッドや、文字セットに関連したさまざまな名前を取得するメソッドを定義します。さらに、特定の文字セットがサポートされているかどうかをテストする静的メソッド、名前から文字セットを検索する静的メソッド、現在の Java 仮想マシンでサポートされているすべての文字セットのマップを構築する静的メソッドも定義します。

ほとんどのユーザは、これらのクラスを直接使用する代わりに、String クラス内の既存の文字セット関連コンストラクタおよびメソッドと、既存の InputStreamReader クラスおよび OutputStreamWriter クラスを使用します。これらの実装はすべて、このパッケージに定義されている文字セット機能を活用できるように変更されています。特に、InputStreamReader クラスと OutputStreamWriter クラスには、そのインスタンスの構築時に明示的に文字セットオブジェクトを指定できるように、若干の変更が加えられています。

新しい文字セットのサポートを追加したい場合は、java.nio.charset.spi パッケージの CharsetProvider クラスに定義されているインタフェースを使用します。

導入されたバージョン:

1.4