モジュール java.base

パッケージjava.nio.charset

パッケージjava.nio.charset

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

このパッケージの文字セット、デコーダおよびエンコーダのサマリー

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

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

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

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

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

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

導入されたバージョン:

1.4

関連パッケージ

パッケージ	説明
java.nio	データのコンテナであるバッファについて定義し、その他のNIOパッケージの概要情報を提供します。
java.nio.charset.spi	java.nio.charsetパッケージのサービス・プロバイダ・クラス。
java.nio.channels	入出力操作を実行できるエンティティ(ファイル、ソケットなど)への接続を表すチャネルや、多重化された非ブロック入出力操作用のセレクタを定義します。
java.nio.file	ファイル、ファイル属性、およびファイル・システムにアクセスするためのJava仮想マシン用のインタフェースとクラスを定義します。

クラス	説明
CharacterCodingException	文字のエンコード・エラーやデコード・エラーが発生したときにスローされるチェック例外です。
Charset	16ビットUnicode コード単位のシーケンスとバイト・シーケンス間の指定マップです。
CharsetDecoder	特定の文字セットで表現されたバイト・シーケンスを16ビットUnicode文字のシーケンスに変換するエンジンです。
CharsetEncoder	16ビットUnicode文字のシーケンスを特定の文字セットで表現されたバイト・シーケンスに変換するエンジンです。
CoderMalfunctionError	CharsetDecoderのdecodeLoopメソッドまたはCharsetEncoderのencodeLoopメソッドから予期しない例外がスローされたときにスローされるエラーです。
CoderResult	コーダーの結果状態の説明です。
CodingErrorAction	コーディング・エラーが発生したときに実行するアクションの型保証された列挙です。
IllegalCharsetNameException	ある文字列が、正当な文字セット名ではないのに正当であるかのように使用された場合にスローされる非チェック例外です。
MalformedInputException	入力バイト・シーケンスが指定文字セットにとって正当でない場合、または入力文字シーケンスが16ビットの正規Unicodeシーケンスでない場合にスローされるチェック例外です。
StandardCharsets	標準charsets用の定数定義。
UnmappableCharacterException	入力文字(またはバイト)シーケンスは有効だが出力バイト(または文字)シーケンスにマップできない場合にスローされるチェック例外です。
UnsupportedCharsetException	要求された文字セットがサポートされない場合にスローされる非チェック例外です。