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对于那些描述溢或上溢条件的结果对象。

从以下版本开始：

1.4

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

字段详细信息

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

抛出与此对象描述的结果相适应的异常。

异常

BufferUnderflowException - 如果这个对象是 UNDERFLOW

BufferOverflowException - 如果此对象为 OVERFLOW

MalformedInputException - 如果此对象表示格式错误的错误; 异常的长度值将是该对象的长度值

UnmappableCharacterException - 如果此对象表示不可映射的字符错误; 异常长度值将是该对象的长度值

CharacterCodingException