モジュール java.base
パッケージ java.nio.charset

クラスCoderResult

java.lang.Object
java.nio.charset.CoderResult
public class CoderResult extends Object
コーダーの結果状態の説明です。

文字セットのコーダー(デコーダまたはエンコーダ)は、入力バッファ内のバイトまたは文字を消費し、変換して、結果として得られる文字またはバイトを出力バッファに書き込みます。 コーディング・プロセスは、次の4つのカテゴリのいずれかで終了します。なお、これらは、このクラスのインスタンスによって表されます。

  • アンダーフローは、処理する入力がこれ以上なくなった場合、または入力内容が不完全で追加入力が必要な場合に報告されます。 この条件は、isUnderflowメソッドがtrueを返す一意の結果オブジェクトUNDERFLOWによって表されます。

  • オーバーフローは、出力バッファの容量が不足したときに報告されます。 この条件は、isOverflowメソッドがtrueを返す一意の結果オブジェクトOVERFLOWによって表されます。

  • 不正入力エラーは、入力ユニットのシーケンスが不正な場合に報告されます。 このようなエラーは、isMalformedメソッドがtrueを返し、lengthメソッドが不正な順序の長さを戻す、このクラスのインスタンスによって記述されます。 特定の長さの不正入力エラーはすべて、このクラスの一意のインスタンス1個で表されます。

  • マップ不可文字エラーは、入力ユニットのシーケンスが出力文字セットで表現できない文字であるときに報告されます。 このようなエラーは、isUnmappableメソッドがtrueを返し、そのlengthメソッドがマップ不可能な文字を示す入力シーケンスの長さを返す、このクラスのインスタンスによって記述されます。 特定の長さのマップ不可文字エラーはすべて、このクラスの一意のインスタンス1個で表されます。

便宜上、isErrorメソッドは、不正な入力およびマップ不可能な文字エラーを記述する結果オブジェクトに対してtrueを返し、アンダー・フローまたはオーバーフロー条件を記述する結果オブジェクトに対してはfalseを返します。

導入されたバージョン:
1.4