to top
Android APIs
public class

CoderResult

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

Class Overview

Used to indicate the result of encoding/decoding. There are four types of results:

  1. UNDERFLOW indicates that all input has been processed but more input is required. It is represented by the unique object CoderResult.UNDERFLOW.
  2. OVERFLOW indicates an insufficient output buffer size. It is represented by the unique object CoderResult.OVERFLOW.
  3. A malformed-input error indicates that an unrecognizable sequence of input units has been encountered. Get an instance of this type of result by calling CoderResult.malformedForLength(int) with the length of the malformed-input.
  4. An unmappable-character error indicates that a sequence of input units can not be mapped to the output charset. Get an instance of this type of result by calling CoderResult.unmappableForLength(int) with the input sequence size indicating the identity of the unmappable character.

Summary

Fields
public static final CoderResult OVERFLOW Result object used to indicate that the output buffer does not have enough space available to store the result of the encoding/decoding.
public static final CoderResult UNDERFLOW Result object indicating that there is insufficient data in the encoding/decoding buffer or that additional data is required.
Public Methods
boolean isError()
Returns true if this result represents a malformed-input error or an unmappable-character error.
boolean isMalformed()
Returns true if this result represents a malformed-input error.
boolean isOverflow()
Returns true if this result is an overflow condition.
boolean isUnderflow()
Returns true if this result is an underflow condition.
boolean isUnmappable()
Returns true if this result represents an unmappable-character error.
int length()
Returns the length of the erroneous input.
synchronized static CoderResult malformedForLength(int length)
Gets a CoderResult object indicating a malformed-input error.
void throwException()
Throws an exception corresponding to this coder result.
String toString()
Returns a text description of this result.
synchronized static CoderResult unmappableForLength(int length)
Gets a CoderResult object indicating an unmappable character error.
[Expand]
Inherited Methods
From class java.lang.Object

Fields

public static final CoderResult OVERFLOW

Added in API level 1

Result object used to indicate that the output buffer does not have enough space available to store the result of the encoding/decoding.

public static final CoderResult UNDERFLOW

Added in API level 1

Result object indicating that there is insufficient data in the encoding/decoding buffer or that additional data is required.

Public Methods

public boolean isError ()

Added in API level 1

Returns true if this result represents a malformed-input error or an unmappable-character error.

public boolean isMalformed ()

Added in API level 1

Returns true if this result represents a malformed-input error.

public boolean isOverflow ()

Added in API level 1

Returns true if this result is an overflow condition.

public boolean isUnderflow ()

Added in API level 1

Returns true if this result is an underflow condition.

public boolean isUnmappable ()

Added in API level 1

Returns true if this result represents an unmappable-character error.

public int length ()

Added in API level 1

Returns the length of the erroneous input. The length is only meaningful for a malformed-input error or an unmappable character error.

Throws
UnsupportedOperationException if this result is an overflow or underflow.

public static synchronized CoderResult malformedForLength (int length)

Added in API level 1

Gets a CoderResult object indicating a malformed-input error.

Parameters
length the length of the malformed-input.
Returns
  • a CoderResult object indicating a malformed-input error.
Throws
IllegalArgumentException if length is non-positive.

public void throwException ()

Added in API level 1

Throws an exception corresponding to this coder result.

Throws
BufferUnderflowException in case this is an underflow.
BufferOverflowException in case this is an overflow.
UnmappableCharacterException in case this is an unmappable-character error.
MalformedInputException in case this is a malformed-input error.
CharacterCodingException the default exception.

public String toString ()

Added in API level 1

Returns a text description of this result.

Returns
  • a text description of this result.

public static synchronized CoderResult unmappableForLength (int length)

Added in API level 1

Gets a CoderResult object indicating an unmappable character error.

Parameters
length the length of the input unit sequence denoting the unmappable character.
Returns
  • a CoderResult object indicating an unmappable character error.
Throws
IllegalArgumentException if length is non-positive.