|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.nio.charset.CoderResult
コーダの結果状態の説明です。
文字セットのコーダ (デコーダまたはエンコーダ) は、入力バッファ内のバイトまたは文字を消費し、変換して、生成された文字またはバイトを出力バッファに書き込みます。コーディングプロセスは、次の 4 つのカテゴリのいずれかで終了します。なお、これらは、このクラスのインスタンスによって表されます。
「アンダーフロー」。これ以上処理する入力がなくなった場合、または入力内容が不完全だったため補足入力が必要な場合に報告されます。この条件は、一意の結果オブジェクト UNDERFLOW
の isUnderflow
メソッドが true を返すことによって表されます。
「オーバーフロー」。出力バッファの容量が不足したときに報告されます。この条件は、一意の結果オブジェクト OVERFLOW
の isOverflow
メソッドが true を返すことによって表されます。
「不正入力エラー」。入力ユニットのシーケンスが不正な場合に報告されます。こうしたエラーは、このクラスのインスタンスの isMalformed
メソッドが true を返し、length
メソッドが不正なシーケンスの長さを返すことによって表されます。一定の長さの不正入力エラーはすべて、このクラスの一意のインスタンス 1 個で表されます。
「マップ不可文字エラー」。入力ユニットのシーケンスが、出力文字セットで表現できない文字であるときに報告されます。こうしたエラーは、このクラスのインスタンスの isUnmappable
メソッドが true を返し、length
メソッドがマップ不可文字を示す入力シーケンスの長さを返すことによって表されます。一定の長さのマップ不可文字エラーはすべて、このクラスの一意のインスタンス 1 個で表されます。
isError
メソッドは、不正入力エラーやマップ不可文字エラーを示す結果オブジェクトに対しては true、アンダーフロー条件やオーバーフロー条件を示す結果オブジェクトに対しては false を返します。
フィールドの概要 | |
static CoderResult |
OVERFLOW
オーバーフローを示す結果オブジェクトで、出力バッファの容量が不足している状態を示します。 |
static CoderResult |
UNDERFLOW
アンダーフローを示す結果オブジェクトで、入力バッファが完全に消費された状態か、入力バッファがまだ空でない場合は追加入力が必要である状態を示します。 |
メソッドの概要 | |
boolean |
isError()
このオブジェクトがエラー条件を示しているかどうかを判断します。 |
boolean |
isMalformed()
このオブジェクトが不正入力エラーを示しているかどうかを判断します。 |
boolean |
isOverflow()
このオブジェクトがオーバーフロー条件を示しているかどうかを判断します。 |
boolean |
isUnderflow()
このオブジェクトがアンダーフロー条件を示しているかどうかを判断します。 |
boolean |
isUnmappable()
このオブジェクトがマップ不可文字エラーを示しているかどうかを判断します。 |
int |
length()
このオブジェクトによって示されるエラー入力の長さを返します (オプション)。 |
static CoderResult |
malformedForLength(int length)
指定された長さの不正入力エラーを示す、一意のオブジェクトを返す静的ファクトリメソッドです。 |
void |
throwException()
このオブジェクトが示す結果に応じて例外をスローします。 |
String |
toString()
このコーダの結果を説明する文字列を返します。 |
static CoderResult |
unmappableForLength(int length)
指定された長さのマップ不可文字エラーを示す、一意のオブジェクトを返す静的ファクトリメソッドです。 |
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
フィールドの詳細 |
public static final CoderResult UNDERFLOW
public static final CoderResult OVERFLOW
メソッドの詳細 |
public String toString()
Object
内の toString
public boolean isUnderflow()
public boolean isOverflow()
public boolean isError()
public boolean isMalformed()
public boolean isUnmappable()
public int length()
UnsupportedOperationException
- このオブジェクトがエラー条件を示していない場合、すなわち isError
が true を返さない場合public static CoderResult malformedForLength(int length)
public static CoderResult unmappableForLength(int length)
public void throwException() throws CharacterCodingException
BufferUnderflowException
- このオブジェクトが UNDERFLOW
である場合
BufferOverflowException
- このオブジェクトが OVERFLOW
である場合
MalformedInputException
- このオブジェクトが不正入力エラーを示す場合、例外の長さの値はこのオブジェクトの長さと同じになる
UnmappableCharacterException
- このオブジェクトがマップ不可文字エラーを示す場合、例外の長さの値はこのオブジェクトの長さと同じになる
CharacterCodingException
|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.