Class CharsetEncoder

lib/java/nio/charset/CharsetEncoder.java:86–798

A converter that can converts a 16-bit Unicode character sequence to a byte sequence in some charset. The input character sequence is wrapped by a java.nio.CharBuffer CharBuffer and the output character sequence is a java.nio.ByteBuffer ByteBuffer. An encoder instance should be u

 * @see java.nio.charset.CharsetDecoder
 */
public abstract class CharsetEncoder {

    /*
     * internal status consts
     */
    private static final int READY = 0;

    private static final int ONGOING = 1;

    private static final int END = 2;

    private static final int FLUSH = 3;

    private static final int INIT = 4;

    // the Charset which creates this encoder
    private Charset cs;

    // average bytes per character created by this encoder
    private float averBytes;

    // maximum bytes per character can be created by this encoder
    private float maxBytes;

    // replacement byte array
    private byte[] replace;

    // internal status
    private int status;

    // internal status indicates encode(CharBuffer) operation is finished
    private boolean finished;

    // action for malformed input
    private CodingErrorAction malformAction;

    // action for unmapped char input
    private CodingErrorAction unmapAction;

    // decoder instance for this encoder's charset, used for replacement value
    // checking
    private CharsetDecoder decoder;

    /**
     * Constructs a new <code>CharsetEncoder</code> using the given
     * <code>Charset</code>, average number and maximum number of bytes
     * created by this encoder for one input character.
     * 
     * @param cs
     *            the <code>Charset</code> to be used by this encoder.
     * @param averageBytesPerChar
     *            average number of bytes created by this encoder for one input
     *            character, must be positive.
     * @param maxBytesPerChar
     *            maximum number of bytes which can be created by this encoder
     *            for one input character, must be positive.
     * @throws IllegalArgumentException
     *             if <code>maxBytesPerChar</code> or