compact1, compact2, compact3

java.nio.charset

Class CoderResult

java.lang.Object

java.nio.charset.CoderResult

public class CoderResult
extends Object

编码器的结果状态的描述。

一个字符集编码，即一个解码器或编码器，消耗的字节（或字）从输入缓冲区，将它们转换，并写入相应的字符（或字节）到输出缓冲区。一个编码过程终止于四类的原因之一，这是由本类的实例描述的：

• 底流报道时有没有更多的输入进行处理，或没有足够的投入，需要额外的输入。这种情况是由独特的结果对象UNDERFLOW为代表，其isUnderflow方法返回true。

• 溢出报道时有足够的空间保持在输出缓冲区。这种情况是由独特的结果对象OVERFLOW为代表，其isOverflow方法返回true。

• 一个格式不正确的输入错误报告时，一系列的输入单元形成不好。这样的错误是由这类的isMalformed方法返回true的length方法返回的实例描述了畸形的序列长度。对于一个给定长度的所有格式不正确的输入错误，这一类的唯一实例。

• 一个无法映射的字符错误报告时，一系列的输入单元代表一个不能在输出字符集表示的字符。这样的错误是由这类的isUnmappable方法返回true的length方法返回输入序列表示无法映射的字符长度的实例描述。对于一个给定长度的所有无法映射的字符错误这一类的唯一实例。

为方便起见，isError方法返回的结果对象true描述格式不正确的输入，无法映射的字符错误但那些描述下溢或上溢条件false。

从以下版本开始：

一点四

Field Summary

Fields

Modifier and Type	Field and Description
static CoderResult	OVERFLOW 结果对象表示溢出，这意味着输出缓冲区中有足够的空间。
static CoderResult	UNDERFLOW 结果表明底流，意味着要么输入缓冲区已被完全消耗，如果输入缓冲区是不空的，这需要额外的输入。

方法摘要

Modifier and Type	Method and Description
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) 静态工厂方法返回一个描述给定的长度无法映射的字符错误的独特结果对象。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

UNDERFLOW

public static final CoderResult UNDERFLOW

结果表明底流，意味着要么输入缓冲区已被完全消耗，如果输入缓冲区是不空的，这需要额外的输入。

OVERFLOW

public static final CoderResult OVERFLOW

结果对象表示溢出，这意味着输出缓冲区中有足够的空间。

方法详细信息

toString

public String toString()

返回描述此编码器结果的字符串。

重写：

toString 方法重写，继承类 Object

结果

一个描述性的字符串

isUnderflow

public boolean isUnderflow()

告诉是否这个对象描述下溢条件。

结果

true如果，如果，该对象表示下溢

isOverflow

public boolean isOverflow()

告诉是否该对象描述了一个溢出条件。

结果

true如果，如果，该对象表示溢出

isError

public boolean isError()

告诉该对象是否描述了一个错误条件。

结果

true如果，如果，这个对象是畸形的输入错误或无法映射的字符错误

isMalformed

public boolean isMalformed()

告诉是否这个对象描述了一个畸形的输入错误。

结果

true如果，如果，这个对象代表一个畸形的输入错误

isUnmappable

public boolean isUnmappable()

告诉是否这个对象描述了一个无法映射的字符错误。

结果

true如果，如果，该对象表示一个无法映射的字符错误

length

public int length()

返回该对象 描述错误的输入长度（可选操作）。

结果

错误输入的长度，一个正整数

异常

UnsupportedOperationException -如果该对象没有描述错误的情况，那就是，如果 isError不返回 true

malformedForLength

public static CoderResult malformedForLength(int length)

静态工厂方法返回一个给定长度的描述错误的输入误差的唯一对象。

参数

length -给定的长度

结果

请求的编码器结果对象

unmappableForLength

public static CoderResult unmappableForLength(int length)

静态工厂方法返回一个描述给定的长度无法映射的字符错误的独特结果对象。

参数

给定的长度 length -

结果

请求的编码器结果对象

throwException

public void throwException()
                    throws CharacterCodingException

抛出一个与此对象所描述的结果的异常。

异常

如果这个对象是 UNDERFLOW BufferUnderflowException

如果这个对象是 OVERFLOW BufferOverflowException

MalformedInputException -如果该对象表示一个畸形的输入错误；异常的长度值，将该对象

UnmappableCharacterException -如果该对象表示一个无法映射的字符错误；例外的长度值，将该对象

CharacterCodingException