パッケージ 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 バッファーや文字バッファーを操作します。この 2 つをまとめて「コーダー」と呼びます。

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

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

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

ほかで指定がない場合、null 引数をコンストラクタ、またはこのパッケージの任意のクラスまたはインタフェースのメソッドへ渡すと NullPointerException がスローされます。

導入されたバージョン:

1.4