CoderResult

public class CoderResult
extends Object

java.lang.Object
↳	java.nio.charset.CoderResult

---

编码器结果状态的描述。

字符编码器，即解码器或编码器，消耗来自输入缓冲器的字节（或字符），翻译它们，并将结果字符（或字节）写入输出缓冲器。 编码过程因以下四类原因之一而终止：该类由实例描述：

• 如果没有更多的输入需要处理，或者输入数据不足，需要额外的输入，则会报告下溢 。 该条件由唯一结果对象UNDERFLOW ，其isUnderflow方法返回true 。

• 当输出缓冲区中剩余空间不足时会报告溢出 。 此情况由唯一结果对象OVERFLOW ，其isOverflow方法返回true 。

• 当输入单元序列格式不正确时，会报告格式错误的输入错误 。 此类错误由该类的实例描述，该类的isMalformed方法返回true ，其length方法返回格式错误的序列的长度。 对于给定长度的所有格式错误的输入错误，这个类有一个唯一的实例。

• 当输入单元序列表示不能在输出字符集中表示的字符时，会报告不可映射字符错误 。 此类错误由该类的实例描述，该类的isUnmappable方法返回true ，其length方法返回表示不可映射字符的输入序列的长度。 对于给定长度的所有不可映射字符错误，此类有一个唯一的实例。

For convenience, the isError method returns true for result objects that describe malformed-input and unmappable-character errors but false for those that describe underflow or overflow conditions.

Summary

Fields
public static final CoderResult	OVERFLOW 结果对象指示溢出，意味着输出缓冲区中没有足够的空间。
public static final CoderResult	UNDERFLOW 指示下溢的结果对象，表示输入缓冲区已被完全消耗，或者如果输入缓冲区尚未为空，则需要额外的输入。

Public methods
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) 静态工厂方法，返回描述给定长度的不可映射字符错误的唯一结果对象。

Inherited methods

From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为该对象调用 notify()方法或 notifyAll()方法，或者某个其他线程中断当前线程，或者经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。

Fields

Public methods