/*
?*?@（#）ByteToCharConverter.java	1.40?04/05/18
?*
?*?Copyright?2004?Sun?Microsystems?Inc.?All?rights?reserved.
?*?SUN?PROPRIETARY/CONFIDENTIAL.?Use?is?subject?to?license?terms.
?*/

package?sun.io;

import?java.io.*;


/**
?*?An?abstract?base?class?for?subclasses?which?convert?character?data
?*?in?an?external?encoding?into?Unicode?characters.
?*
?*?@author?Asmus?Freytag
?*?@author?Lloyd?Honomichl
?*
?*?@deprecated?Replaced?by?{@link?java.nio.charset}.??THIS?API?WILL?BE
?*?REMOVED?IN?J2SE?1.6.
?*/
@Deprecated
public?abstract?class?ByteToCharConverter?{

????/*
?????*?Substitution?mode?flag.
?????*/
????protected?boolean?subMode?=?true;

????/*
?????*?Characters?to?use?for?automatic?substitution.??
?????*/
????protected?char[]?subChars?=?{?‘\uFFFD‘?};

????/*
?????*?Offset?of?next?character?to?be?output
?????*/
????protected?int?charOff;

????/*
?????*?Offset?of?next?byte?to?be?converted
?????*/
????protected?int?byteOff;

????/*
?????*?Length?of?bad?input?that?caused?a?MalformedInputException.
?????*/
????protected?int?badInputLength;

????/**
?????*?Create?an?instance?of?the?default?ByteToCharConverter?subclass.
?????*/
????public?static?ByteToCharConverter?getDefault（）?{
	object?cvt;
	cvt?=?Converters.newDefaultConverter（Converters.BYTE_TO_CHAR）;
	return?（ByteToCharConverter）cvt;
????}

????/**
?????*?Returns?appropriate?ByteToCharConverter?subclass?instance.
?????*?@param?string?represents?encoding
?????*/
????public?static?ByteToCharConverter?getConverter（String?encoding）
	throws?UnsupportedEncodingException
????{
	object?cvt;
	cvt?=?Converters.newConverter（Converters.BYTE_TO_CHAR?encoding）;
	return?（ByteToCharConverter）cvt;
????}

????/**
?????*?Returns?the?character?set?id?for?the?conversion
?????*/
????public?abstract?String?getCharacterEncoding（）;

????/**
?????*?Converts?an?array?of?bytes?containing?characters?in?an?external
?????*?encoding?into?an?array?of?Unicode?characters.??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?exception?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.
?????*
?????*?@return?the?number?of?bytes?written?to?output.
?????*?@param?input?byte?array?containing?text?to?be?converted.
?????*?@param?inStart?begin?conversion?at?this?offset?in?input?array.
?????*?@param?inEnd?stop?conversion?at?this?offset?in?input?array?（exclusive）.
?????*?@param?output?character?array?to?receive?conversion?result.
?????*?@param?outStart?start?writing?to?output?array?at?this?offset.
?????*?@param?outEnd?stop?writing?to?output?array?at?this?offset?（exclusive）.
?????*?@exception?MalformedInputException?if?the?input?buffer?contains?any
?????*?sequence?of?bytes?that?is?illegal?for?the