/*
 * Copyright (c) 1996, 2002, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

package sun.io;

/**
 * A table driven conversion from byte to char for single byte  character sets.
 * The needed data tables will reside in a character set specific subclass.
 *
 * @author Lloyd Honomichl
 * @author Asmus Freytag
 */
public abstract class ByteToCharSingleByte extends ByteToCharConverter {

    /**
     * Mapping table. Values supplied by subclass
     */
    protected String byteToCharTable;

    public String getByteToCharTable() {
	return byteToCharTable;
    }

    public int flush(char[] output, int outStart, int outEnd) {
	byteOff = charOff = 0;
	return 0;
    }

    /**
     * Converts bytes to characters according to the selected character
     * encoding.
     * Maintains internal state, so that conversions that result in
     * exceptions can be restarted by calling convert again, with
     * appropriately modified parameters.
     * Call reset before converting input that is not a continuation of
     * the previous call.
     * @return the number of characters written to output.
     * @param input byte array containing text in character set
     * @param inStart offset in input array
     * @param inEnd offset of last byte to be converted
     * @param output character array to receive conversion result
     * @param outStart starting offset
     * @param outEnd offset of last character to be written to
     * @throw MalformedInputException for any sequence of bytes that is
     * illegal for the input character set, including any partial multi-byte
     * sequence which occurs at the end of an input buffer.
     * @throw UnsupportedCharacterException for any sequence of bytes that
     * contain a character not supported in the current conversion.
     * @throw BufferFullException whenever the output buffer is full
     * before the input is exhausted.
     * @see #reset
     */
    public int convert(byte[] input, int inOff, int inEnd,
		       char[] output, int outOff, int outEnd)
        throws UnknownCharacterException,
               MalformedInputException,
               ConversionBufferFullException
    {
    	char	outputChar;
	int 	byteIndex;

        charOff = outOff;
        byteOff = inOff;

        // Loop until we hit the end of the input
        while(byteOff < inEnd) {

	    byteIndex = input[byteOff];

	    /* old source 
	     *outputChar = byteToCharTable[input[byteOff] + 128];
	     */
	    // Lookup the output character
	    outputChar = getUnicode(byteIndex);

	    // Is the output unmappable?
	    if (outputChar == '\uFFFD')	{
		if (subMode) {
		    outputChar = subChars[0];
		} else {
		    badInputLength = 1;
		    throw new UnknownCharacterException();
		}
            }

	    // If we don't have room for the output, throw an exception
	    if (charOff >= outEnd)
		throw new ConversionBufferFullException();

	    // Put the character in the output buffer
	    output[charOff]= outputChar;
	    charOff++;
	    byteOff++;
        }
	
    	// Return the length written to the output buffer
	return charOff-outOff;
    }

    protected char getUnicode(int byteIndex) {
	int n = byteIndex + 128;
	if (n >= byteToCharTable.length() || n < 0) 
	    return '\uFFFD';
	return byteToCharTable.charAt(n);
    }

    /**
     *  Resets the converter.
     *  Call this method to reset the converter to its initial state
     */
    public void reset() {
	byteOff = charOff = 0;
    }

}