This is a facade method for decoding operation.
This method decodes the remaning byte sequence of the given byte buffer into a new character buffer. This method performs a complete decoding operation, resets at first, then decodes, and flushes at last.
This method should not be invoked if another decode operation is ongoing.
@param in the input buffer
@return a new
CharBuffer
containing the the charactersproduced by this decoding operation. The buffer's limit will be the position of last character in buffer, and the position will be zero
@throws IllegalStateException if another decoding operation is ongoing
@throws MalformedInputException if illegal input byte sequence for this charset encountered, and the action for malformed error is {@link CodingErrorAction#REPORT CodingErrorAction.REPORT}
@throws UnmappableCharacterException if legal but unmappable input byte sequence for this charset encountered, and the action for unmappable character error is {@link CodingErrorAction#REPORT CodingErrorAction.REPORT}. Unmappable means the byte sequence at the input buffer's current postion cannot be mapped to a Unicode character sequence.
@throws CharacterCodingException if other exception happened during the decode operation