public class

CharToByteUnicode

extends CharToByteConverter

java.lang.Object
↳	sun.io.CharToByteConverter
	↳	sun.io.CharToByteUnicode

Known Direct Subclasses

CharToByteUTF16, CharToByteUnicodeBig, CharToByteUnicodeBigUnmarked, CharToByteUnicodeLittle, CharToByteUnicodeLittleUnmarked

Class Overview

Convert arrays containing Unicode characters into arrays of bytes, using the platform-default byte order.

Summary

Fields
protected int	byteOrder
protected boolean	usesMark

[Expand]

Inherited Fields

From class sun.io.CharToByteConverter

Public Constructors
	CharToByteUnicode()
	CharToByteUnicode(int byteOrder, boolean usesMark)
	CharToByteUnicode(boolean usesMark)

Public Methods
int	convert(char[] in, int inOff, int inEnd, byte[] out, int outOff, int outEnd) Converts an array of Unicode characters into an array of bytes in the target character encoding.
int	flush(byte[] in, int inOff, int inEnd) Writes any remaining output to the output buffer and resets the converter to its initial state.
String	getCharacterEncoding() Returns the character set id for the conversion.
int	getMaxBytesPerChar() Returns the maximum number of bytes needed to convert a char.
void	reset() Resets converter to its initial state.

[Expand]

Inherited Methods

From class sun.io.CharToByteConverter

boolean	canConvert(char c) Returns true if the given character can be converted to the target character encoding.
abstract int	convert(char[] input, int inStart, int inEnd, byte[] output, int outStart, int outEnd) Converts an array of Unicode characters into an array of bytes in the target character encoding.
byte[]	convertAll(char[] input) Converts an array of Unicode characters into an array of bytes in the target character encoding.
int	convertAny(char[] input, int inStart, int inEnd, byte[] output, int outStart, int outEnd)
abstract int	flush(byte[] output, int outStart, int outEnd) Writes any remaining output to the output buffer and resets the converter to its initial state.
int	flushAny(byte[] output, int outStart, int outEnd) Writes any remaining output to the output buffer and resets the converter to its initial state.
int	getBadInputLength() Returns the length, in chars, of the input which caused a MalformedInputException.
abstract String	getCharacterEncoding() Returns the character set id for the conversion.
static CharToByteConverter	getConverter(String encoding) Returns appropriate CharToByteConverter subclass instance.
static CharToByteConverter	getDefault() Create an instance of the default CharToByteConverter subclass.
abstract int	getMaxBytesPerChar() Returns the maximum number of bytes needed to convert a char.
int	nextByteIndex() Returns the index of the byte just past the last byte written by the previous call to convert.
int	nextCharIndex() Returns the index of the character just past the last character successfully converted by the previous call to convert.
abstract void	reset() Resets converter to its initial state.
void	setSubstitutionBytes(byte[] newSubBytes) Sets the substitution bytes to use when the converter is in substitution mode.
void	setSubstitutionMode(boolean doSub) Sets converter into substitution mode.
String	toString() Returns a string representation of the class.

From class java.lang.Object

Object	clone() Creates and returns a copy of this object.
boolean	equals(Object obj) Indicates whether some other object is "equal to" this one.
void	finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
final Class<?>	getClass() Returns the runtime class of this `Object`.
int	hashCode() Returns a hash code value for the object.
final void	notify() Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll() Wakes up all threads that are waiting on this object's monitor.
String	toString() Returns a string representation of the object.
final void	wait() Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.
final void	wait(long timeout, int nanos) Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
final void	wait(long timeout) Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.

Fields

protected int byteOrder

protected boolean usesMark

Public Constructors

public CharToByteUnicode ()

public CharToByteUnicode (int byteOrder, boolean usesMark)

public CharToByteUnicode (boolean usesMark)

Public Methods

public int convert (char[] in, int inOff, int inEnd, byte[] out, int outOff, int outEnd)

Converts an array of Unicode characters into an array of bytes in the target character encoding. This method allows a buffer by buffer conversion of a data stream. The state of the conversion is saved between calls to convert. 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.

Parameters

in	array containing Unicode characters to be converted.
inOff	begin conversion at this offset in input array.
inEnd	stop conversion at this offset in input array (exclusive).
out	byte array to receive conversion result.
outOff	start writing to output array at this offset.
outEnd	stop writing to output array at this offset (exclusive).

Returns

the number of bytes written to output.

Throws

ConversionBufferFullException
MalformedInputException

public int flush (byte[] in, int inOff, int inEnd)

Writes any remaining output to the output buffer and resets the converter to its initial state.

Parameters

in	byte array to receive flushed output.
inOff	start writing to output array at this offset.
inEnd	stop writing to output array at this offset (exclusive).

public String getCharacterEncoding ()

Returns the character set id for the conversion.

public int getMaxBytesPerChar ()

Returns the maximum number of bytes needed to convert a char. Useful for calculating the maximum output buffer size needed for a particular input buffer.

public void reset ()

Resets converter to its initial state.

Classes

Exceptions

CharToByteUnicode

Class Overview

Summary

Fields

protected int byteOrder

protected boolean usesMark

Public Constructors

public CharToByteUnicode ()

public CharToByteUnicode (int byteOrder, boolean usesMark)

public CharToByteUnicode (boolean usesMark)

Public Methods

public int convert (char[] in, int inOff, int inEnd, byte[] out, int outOff, int outEnd)

Parameters

Returns

Throws

public int flush (byte[] in, int inOff, int inEnd)

Parameters

public String getCharacterEncoding ()

public int getMaxBytesPerChar ()

public void reset ()