com.ibm.icu.charset
Class CharsetDecoderICU

java.lang.Object
  java.nio.charset.CharsetDecoder
      com.ibm.icu.charset.CharsetDecoderICU

public abstract class CharsetDecoderICU
extends java.nio.charset.CharsetDecoder

An abstract class that provides framework methods of decoding operations for concrete subclasses. In the future this class will contain API that will implement converter sematics of ICU4C.

Status:

Draft ICU 3.6.

Method Summary

protected java.nio.charset.CoderResult	decodeLoop(java.nio.ByteBuffer in, java.nio.CharBuffer out) Decodes one or more bytes.
protected java.nio.charset.CoderResult	implFlush(java.nio.CharBuffer out) Flushes any characters saved in the converter's internal buffer and resets the converter.
protected void	implOnMalformedInput(java.nio.charset.CodingErrorAction newAction) Sets the action to be taken if an illegal sequence is encountered
protected void	implOnUnmappableCharacter(java.nio.charset.CodingErrorAction newAction) Sets the action to be taken if an illegal sequence is encountered
protected void	implReset() Resets the to Unicode mode of converter

Methods inherited from class java.nio.charset.CharsetDecoder

averageCharsPerByte, charset, decode, decode, detectedCharset, flush, implReplaceWith, isAutoDetecting, isCharsetDetected, malformedInputAction, maxCharsPerByte, onMalformedInput, onUnmappableCharacter, replacement, replaceWith, reset, unmappableCharacterAction

Methods inherited from class java.lang.Object

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

Method Detail

implOnMalformedInput

protected final void implOnMalformedInput(java.nio.charset.CodingErrorAction newAction)

Sets the action to be taken if an illegal sequence is encountered

Overrides:

implOnMalformedInput in class java.nio.charset.CharsetDecoder

Parameters:

newAction - action to be taken

Throws:

java.lang.IllegalArgumentException

Status:

Stable ICU 3.6.

implOnUnmappableCharacter

protected final void implOnUnmappableCharacter(java.nio.charset.CodingErrorAction newAction)

Sets the action to be taken if an illegal sequence is encountered

Overrides:

implOnUnmappableCharacter in class java.nio.charset.CharsetDecoder

Parameters:

newAction - action to be taken

Throws:

java.lang.IllegalArgumentException

Status:

Stable ICU 3.6.

implFlush

protected final java.nio.charset.CoderResult implFlush(java.nio.CharBuffer out)

Flushes any characters saved in the converter's internal buffer and resets the converter.

Overrides:

implFlush in class java.nio.charset.CharsetDecoder

Parameters:

out - action to be taken

Returns:

result of flushing action and completes the decoding all input. Returns CoderResult.UNDERFLOW if the action succeeds.

Status:

Stable ICU 3.6.

implReset

protected void implReset()

Resets the to Unicode mode of converter

Overrides:

implReset in class java.nio.charset.CharsetDecoder

Status:

Stable ICU 3.6.

decodeLoop

protected java.nio.charset.CoderResult decodeLoop(java.nio.ByteBuffer in,
                                                  java.nio.CharBuffer out)

Decodes one or more bytes. The default behaviour of the converter is stop and report if an error in input stream is encountered. To set different behaviour use @see CharsetDecoder.onMalformedInput() This method allows a buffer by buffer conversion of a data stream. The state of the conversion is saved between calls to convert. Among other things, this means multibyte input sequences can be split between calls. If a call to convert results in an Error, the conversion may be continued by calling convert again with suitably modified parameters.All conversions should be finished with a call to the flush method.

Specified by:

decodeLoop in class java.nio.charset.CharsetDecoder

Parameters:

in - buffer to decode

out - buffer to populate with decoded result

Returns:

Result of decoding action. Returns CoderResult.UNDERFLOW if the decoding action succeeds or more input is needed for completing the decoding action.

Status:

Stable ICU 3.6.