Modifier and Type	Class and Description
public class	AWTCharset.Decoder
public class	AWTCharset.Encoder

Modifier and Type	Field and Description
protected Charset	awtCs
protected Charset	javaCs

Access	Constructor and Description
public	AWTCharset(String awtCsName, Charset javaCs)

Modifier and Type	Method and Description
public boolean	contains(Charset cs) Implements abstract java.nio.charset.Charset.contains. Tells whether or not this charset contains the given charset.
public CharsetDecoder	newDecoder() Implements abstract java.nio.charset.Charset.newDecoder. Constructs a new decoder for this charset.
public CharsetEncoder	newEncoder() Implements abstract java.nio.charset.Charset.newEncoder. Constructs a new encoder for this charset.

awtCs	back to summary
protected Charset awtCs

javaCs	back to summary
protected Charset javaCs

AWTCharset	back to summary
public AWTCharset(String awtCsName, Charset javaCs)

contains	back to summary
public boolean contains(Charset cs) Implements abstract java.nio.charset.Charset.contains. Doc from java.nio.charset.Charset.contains. Tells whether or not this charset contains the given charset. A charset C is said to contain a charset D if, and only if, every character representable in D is also representable in C. If this relationship holds then it is guaranteed that every string that can be encoded in D can also be encoded in C without performing any replacements. That C contains D does not imply that each character representable in C by a particular byte sequence is represented in D by the same byte sequence, although sometimes this is the case. Every charset contains itself. This method computes an approximation of the containment relation: If it returns `true` then the given charset is known to be contained by this charset; if it returns `false`, however, then it is not necessarily the case that the given charset is not contained in this charset.

newDecoder	back to summary
public CharsetDecoder newDecoder() Implements abstract java.nio.charset.Charset.newDecoder. Doc from java.nio.charset.Charset.newDecoder. Constructs a new decoder for this charset.

newEncoder	back to summary
public CharsetEncoder newEncoder() Implements abstract java.nio.charset.Charset.newEncoder. Doc from java.nio.charset.Charset.newEncoder. Constructs a new encoder for this charset.

public Class AWTCharset.Decoder

Class Inheritance

Field Summary

Modifier and Type	Field and Description
protected CharsetDecoder	dec
pack-priv ByteBuffer	fbb
private String	nr

Constructor Summary

Access	Constructor and Description
protected	Decoder()
protected	Decoder(CharsetDecoder dec)

Method Summary

Modifier and Type	Method and Description
protected CoderResult	decodeLoop(ByteBuffer src, CharBuffer dst) Implements abstract java.nio.charset.CharsetDecoder.decodeLoop. Decodes one or more bytes into one or more characters.
protected CoderResult	implFlush(CharBuffer out) Overrides java.nio.charset.CharsetDecoder.implFlush. Flushes this decoder.
protected void	implOnMalformedInput(CodingErrorAction newAction) Overrides java.nio.charset.CharsetDecoder.implOnMalformedInput. Reports a change to this decoder's malformed-input action.
protected void	implOnUnmappableCharacter(CodingErrorAction newAction) Overrides java.nio.charset.CharsetDecoder.implOnUnmappableCharacter. Reports a change to this decoder's unmappable-character action.
protected void	implReplaceWith(String newReplacement) Overrides java.nio.charset.CharsetDecoder.implReplaceWith. Reports a change to this decoder's replacement value.
protected void	implReset() Overrides java.nio.charset.CharsetDecoder.implReset. Resets this decoder, clearing any charset-specific internal state.

Inherited from java.nio.charset.CharsetDecoder:: averageCharsPerByte charset decode decode detectedCharset flush isAutoDetecting isCharsetDetected malformedInputAction maxCharsPerByte onMalformedInput onUnmappableCharacter replacement replaceWith reset unmappableCharacterAction

Field Detail

dec	back to summary
protected CharsetDecoder dec

fbb	back to summary
pack-priv ByteBuffer fbb

nr	back to summary
private String nr

Constructor Detail

Decoder	back to summary
protected Decoder()

Decoder	back to summary
protected Decoder(CharsetDecoder dec)

Method Detail

decodeLoop back to summary

decodeLoop	back to summary
protected CoderResult decodeLoop(ByteBuffer src, CharBuffer dst) Implements abstract java.nio.charset.CharsetDecoder.decodeLoop. Doc from java.nio.charset.CharsetDecoder.decodeLoop. Decodes one or more bytes into one or more characters. This method encapsulates the basic decoding loop, decoding as many bytes as possible until it either runs out of input, runs out of room in the output buffer, or encounters a decoding error. This method is invoked by the `decode` method, which handles result interpretation and error recovery. The buffers are read from, and written to, starting at their current positions. At most `in.remaining()` bytes will be read, and at most `out.remaining()` characters will be written. The buffers' positions will be advanced to reflect the bytes read and the characters written, but their marks and limits will not be modified. This method returns a `CoderResult` object to describe its reason for termination, in the same manner as the `decode` method. Most implementations of this method will handle decoding errors by returning an appropriate result object for interpretation by the `decode` method. An optimized implementation may instead examine the relevant error action and implement that action itself. An implementation of this method may perform arbitrary lookahead by returning `CoderResult#UNDERFLOW` until it receives sufficient input.

protected CoderResult decodeLoop(ByteBuffer src, CharBuffer dst)

Implements abstract java.nio.charset.CharsetDecoder.decodeLoop.

Doc from java.nio.charset.CharsetDecoder.decodeLoop.

Decodes one or more bytes into one or more characters.

This method encapsulates the basic decoding loop, decoding as many bytes as possible until it either runs out of input, runs out of room in the output buffer, or encounters a decoding error. This method is invoked by the decode method, which handles result interpretation and error recovery.

The buffers are read from, and written to, starting at their current positions. At most in.remaining() bytes will be read, and at most out.remaining() characters will be written. The buffers' positions will be advanced to reflect the bytes read and the characters written, but their marks and limits will not be modified.

This method returns a CoderResult object to describe its reason for termination, in the same manner as the decode method. Most implementations of this method will handle decoding errors by returning an appropriate result object for interpretation by the decode method. An optimized implementation may instead examine the relevant error action and implement that action itself.

An implementation of this method may perform arbitrary lookahead by returning CoderResult#UNDERFLOW until it receives sufficient input.

implFlush back to summary

implFlush	back to summary
protected CoderResult implFlush(CharBuffer out) Overrides java.nio.charset.CharsetDecoder.implFlush. Doc from java.nio.charset.CharsetDecoder.implFlush. Flushes this decoder. The default implementation of this method does nothing, and always returns `CoderResult#UNDERFLOW`. This method should be overridden by decoders that may need to write final characters to the output buffer once the entire input sequence has been read.

protected CoderResult implFlush(CharBuffer out)

Overrides java.nio.charset.CharsetDecoder.implFlush.

Doc from java.nio.charset.CharsetDecoder.implFlush.

Flushes this decoder.

The default implementation of this method does nothing, and always returns CoderResult#UNDERFLOW. This method should be overridden by decoders that may need to write final characters to the output buffer once the entire input sequence has been read.

implOnMalformedInput	back to summary
protected void implOnMalformedInput(CodingErrorAction newAction) Overrides java.nio.charset.CharsetDecoder.implOnMalformedInput. Doc from java.nio.charset.CharsetDecoder.implOnMalformedInput. Reports a change to this decoder's malformed-input action. The default implementation of this method does nothing. This method should be overridden by decoders that require notification of changes to the malformed-input action.

implOnMalformedInput

back to summary

protected void implOnMalformedInput(CodingErrorAction newAction)

Overrides java.nio.charset.CharsetDecoder.implOnMalformedInput.

Doc from java.nio.charset.CharsetDecoder.implOnMalformedInput.

Reports a change to this decoder's malformed-input action.

The default implementation of this method does nothing. This method should be overridden by decoders that require notification of changes to the malformed-input action.

implOnUnmappableCharacter	back to summary
protected void implOnUnmappableCharacter(CodingErrorAction newAction) Overrides java.nio.charset.CharsetDecoder.implOnUnmappableCharacter. Doc from java.nio.charset.CharsetDecoder.implOnUnmappableCharacter. Reports a change to this decoder's unmappable-character action. The default implementation of this method does nothing. This method should be overridden by decoders that require notification of changes to the unmappable-character action.

implOnUnmappableCharacter

back to summary

protected void implOnUnmappableCharacter(CodingErrorAction newAction)

Overrides java.nio.charset.CharsetDecoder.implOnUnmappableCharacter.

Doc from java.nio.charset.CharsetDecoder.implOnUnmappableCharacter.

Reports a change to this decoder's unmappable-character action.

The default implementation of this method does nothing. This method should be overridden by decoders that require notification of changes to the unmappable-character action.

implReplaceWith	back to summary
protected void implReplaceWith(String newReplacement) Overrides java.nio.charset.CharsetDecoder.implReplaceWith. Doc from java.nio.charset.CharsetDecoder.implReplaceWith. Reports a change to this decoder's replacement value. The default implementation of this method does nothing. This method should be overridden by decoders that require notification of changes to the replacement.

implReplaceWith

back to summary

protected void implReplaceWith(String newReplacement)

Overrides java.nio.charset.CharsetDecoder.implReplaceWith.

Doc from java.nio.charset.CharsetDecoder.implReplaceWith.

Reports a change to this decoder's replacement value.

The default implementation of this method does nothing. This method should be overridden by decoders that require notification of changes to the replacement.

implReset	back to summary
protected void implReset() Overrides java.nio.charset.CharsetDecoder.implReset. Doc from java.nio.charset.CharsetDecoder.implReset. Resets this decoder, clearing any charset-specific internal state. The default implementation of this method does nothing. This method should be overridden by decoders that maintain internal state.

implReset

back to summary

protected void implReset()

Overrides java.nio.charset.CharsetDecoder.implReset.

Doc from java.nio.charset.CharsetDecoder.implReset.

Resets this decoder, clearing any charset-specific internal state.

The default implementation of this method does nothing. This method should be overridden by decoders that maintain internal state.

sun.awt back to summary

public Class AWTCharset.Encoder

Class Inheritance

extends CharsetEncoder

Field Summary

Modifier and Type	Field and Description
protected CharsetEncoder	enc

Constructor Summary

Access	Constructor and Description
protected	Encoder()
protected	Encoder(CharsetEncoder enc)

Method Summary

Modifier and Type	Method and Description
public boolean	canEncode(char c) Overrides java.nio.charset.CharsetEncoder.canEncode. Tells whether or not this encoder can encode the given character.
public boolean	canEncode(CharSequence cs) Overrides java.nio.charset.CharsetEncoder.canEncode. Tells whether or not this encoder can encode the given character sequence.
protected CoderResult	encodeLoop(CharBuffer src, ByteBuffer dst) Implements abstract java.nio.charset.CharsetEncoder.encodeLoop. Encodes one or more characters into one or more bytes.
protected CoderResult	implFlush(ByteBuffer out) Overrides java.nio.charset.CharsetEncoder.implFlush. Flushes this encoder.
protected void	implOnMalformedInput(CodingErrorAction newAction) Overrides java.nio.charset.CharsetEncoder.implOnMalformedInput. Reports a change to this encoder's malformed-input action.
protected void	implOnUnmappableCharacter(CodingErrorAction newAction) Overrides java.nio.charset.CharsetEncoder.implOnUnmappableCharacter. Reports a change to this encoder's unmappable-character action.
protected void	implReplaceWith(byte[] newReplacement) Overrides java.nio.charset.CharsetEncoder.implReplaceWith. Reports a change to this encoder's replacement value.
protected void	implReset() Overrides java.nio.charset.CharsetEncoder.implReset. Resets this encoder, clearing any charset-specific internal state.
public boolean	isLegalReplacement(byte[] repl) Overrides java.nio.charset.CharsetEncoder.isLegalReplacement. Tells whether or not the given byte array is a legal replacement value for this encoder.

Inherited from java.nio.charset.CharsetEncoder:: averageBytesPerChar charset encode encode flush malformedInputAction maxBytesPerChar onMalformedInput onUnmappableCharacter replacement replaceWith reset unmappableCharacterAction

Field Detail

enc	back to summary
protected CharsetEncoder enc

Constructor Detail

Encoder	back to summary
protected Encoder()

Encoder	back to summary
protected Encoder(CharsetEncoder enc)

Method Detail

canEncode back to summary

canEncode	back to summary
public boolean canEncode(char c) Overrides java.nio.charset.CharsetEncoder.canEncode. Doc from java.nio.charset.CharsetEncoder.canEncode. Tells whether or not this encoder can encode the given character. This method returns `false` if the given character is a surrogate character; such characters can be interpreted only when they are members of a pair consisting of a high surrogate followed by a low surrogate. The `canEncode(CharSequence)` method may be used to test whether or not a character sequence can be encoded. This method may modify this encoder's state; it should therefore not be invoked if an encoding operation is already in progress. The default implementation of this method is not very efficient; it should generally be overridden to improve performance.

public boolean canEncode(char c)

Overrides java.nio.charset.CharsetEncoder.canEncode.

Doc from java.nio.charset.CharsetEncoder.canEncode.

Tells whether or not this encoder can encode the given character.

This method returns false if the given character is a surrogate character; such characters can be interpreted only when they are members of a pair consisting of a high surrogate followed by a low surrogate. The canEncode(CharSequence) method may be used to test whether or not a character sequence can be encoded.

This method may modify this encoder's state; it should therefore not be invoked if an encoding operation is already in progress.

The default implementation of this method is not very efficient; it should generally be overridden to improve performance.

canEncode back to summary

canEncode	back to summary
public boolean canEncode(CharSequence cs) Overrides java.nio.charset.CharsetEncoder.canEncode. Doc from java.nio.charset.CharsetEncoder.canEncode. Tells whether or not this encoder can encode the given character sequence. If this method returns `false` for a particular character sequence then more information about why the sequence cannot be encoded may be obtained by performing a full encoding operation. This method may modify this encoder's state; it should therefore not be invoked if an encoding operation is already in progress. The default implementation of this method is not very efficient; it should generally be overridden to improve performance.

public boolean canEncode(CharSequence cs)

Overrides java.nio.charset.CharsetEncoder.canEncode.

Doc from java.nio.charset.CharsetEncoder.canEncode.

Tells whether or not this encoder can encode the given character sequence.

If this method returns false for a particular character sequence then more information about why the sequence cannot be encoded may be obtained by performing a full encoding operation.

This method may modify this encoder's state; it should therefore not be invoked if an encoding operation is already in progress.

The default implementation of this method is not very efficient; it should generally be overridden to improve performance.

encodeLoop back to summary

encodeLoop	back to summary
protected CoderResult encodeLoop(CharBuffer src, ByteBuffer dst) Implements abstract java.nio.charset.CharsetEncoder.encodeLoop. Doc from java.nio.charset.CharsetEncoder.encodeLoop. Encodes one or more characters into one or more bytes. This method encapsulates the basic encoding loop, encoding as many characters as possible until it either runs out of input, runs out of room in the output buffer, or encounters an encoding error. This method is invoked by the `encode` method, which handles result interpretation and error recovery. The buffers are read from, and written to, starting at their current positions. At most `in.remaining()` characters will be read, and at most `out.remaining()` bytes will be written. The buffers' positions will be advanced to reflect the characters read and the bytes written, but their marks and limits will not be modified. This method returns a `CoderResult` object to describe its reason for termination, in the same manner as the `encode` method. Most implementations of this method will handle encoding errors by returning an appropriate result object for interpretation by the `encode` method. An optimized implementation may instead examine the relevant error action and implement that action itself. An implementation of this method may perform arbitrary lookahead by returning `CoderResult#UNDERFLOW` until it receives sufficient input.

protected CoderResult encodeLoop(CharBuffer src, ByteBuffer dst)

Implements abstract java.nio.charset.CharsetEncoder.encodeLoop.

Doc from java.nio.charset.CharsetEncoder.encodeLoop.

Encodes one or more characters into one or more bytes.

This method encapsulates the basic encoding loop, encoding as many characters as possible until it either runs out of input, runs out of room in the output buffer, or encounters an encoding error. This method is invoked by the encode method, which handles result interpretation and error recovery.

The buffers are read from, and written to, starting at their current positions. At most in.remaining() characters will be read, and at most out.remaining() bytes will be written. The buffers' positions will be advanced to reflect the characters read and the bytes written, but their marks and limits will not be modified.

This method returns a CoderResult object to describe its reason for termination, in the same manner as the encode method. Most implementations of this method will handle encoding errors by returning an appropriate result object for interpretation by the encode method. An optimized implementation may instead examine the relevant error action and implement that action itself.

An implementation of this method may perform arbitrary lookahead by returning CoderResult#UNDERFLOW until it receives sufficient input.

implFlush back to summary

implFlush	back to summary
protected CoderResult implFlush(ByteBuffer out) Overrides java.nio.charset.CharsetEncoder.implFlush. Doc from java.nio.charset.CharsetEncoder.implFlush. Flushes this encoder. The default implementation of this method does nothing, and always returns `CoderResult#UNDERFLOW`. This method should be overridden by encoders that may need to write final bytes to the output buffer once the entire input sequence has been read.

protected CoderResult implFlush(ByteBuffer out)

Overrides java.nio.charset.CharsetEncoder.implFlush.

Doc from java.nio.charset.CharsetEncoder.implFlush.

Flushes this encoder.

The default implementation of this method does nothing, and always returns CoderResult#UNDERFLOW. This method should be overridden by encoders that may need to write final bytes to the output buffer once the entire input sequence has been read.

implOnMalformedInput	back to summary
protected void implOnMalformedInput(CodingErrorAction newAction) Overrides java.nio.charset.CharsetEncoder.implOnMalformedInput. Doc from java.nio.charset.CharsetEncoder.implOnMalformedInput. Reports a change to this encoder's malformed-input action. The default implementation of this method does nothing. This method should be overridden by encoders that require notification of changes to the malformed-input action.

implOnMalformedInput

back to summary

protected void implOnMalformedInput(CodingErrorAction newAction)

Overrides java.nio.charset.CharsetEncoder.implOnMalformedInput.

Doc from java.nio.charset.CharsetEncoder.implOnMalformedInput.

Reports a change to this encoder's malformed-input action.

The default implementation of this method does nothing. This method should be overridden by encoders that require notification of changes to the malformed-input action.

implOnUnmappableCharacter	back to summary
protected void implOnUnmappableCharacter(CodingErrorAction newAction) Overrides java.nio.charset.CharsetEncoder.implOnUnmappableCharacter. Doc from java.nio.charset.CharsetEncoder.implOnUnmappableCharacter. Reports a change to this encoder's unmappable-character action. The default implementation of this method does nothing. This method should be overridden by encoders that require notification of changes to the unmappable-character action.

implOnUnmappableCharacter

back to summary

protected void implOnUnmappableCharacter(CodingErrorAction newAction)

Overrides java.nio.charset.CharsetEncoder.implOnUnmappableCharacter.

Doc from java.nio.charset.CharsetEncoder.implOnUnmappableCharacter.

Reports a change to this encoder's unmappable-character action.

The default implementation of this method does nothing. This method should be overridden by encoders that require notification of changes to the unmappable-character action.

implReplaceWith	back to summary
protected void implReplaceWith(byte[] newReplacement) Overrides java.nio.charset.CharsetEncoder.implReplaceWith. Doc from java.nio.charset.CharsetEncoder.implReplaceWith. Reports a change to this encoder's replacement value. The default implementation of this method does nothing. This method should be overridden by encoders that require notification of changes to the replacement.

implReplaceWith

back to summary

protected void implReplaceWith(byte[] newReplacement)

Overrides java.nio.charset.CharsetEncoder.implReplaceWith.

Doc from java.nio.charset.CharsetEncoder.implReplaceWith.

Reports a change to this encoder's replacement value.

The default implementation of this method does nothing. This method should be overridden by encoders that require notification of changes to the replacement.

implReset	back to summary
protected void implReset() Overrides java.nio.charset.CharsetEncoder.implReset. Doc from java.nio.charset.CharsetEncoder.implReset. Resets this encoder, clearing any charset-specific internal state. The default implementation of this method does nothing. This method should be overridden by encoders that maintain internal state.

implReset

back to summary

protected void implReset()

Overrides java.nio.charset.CharsetEncoder.implReset.

Doc from java.nio.charset.CharsetEncoder.implReset.

Resets this encoder, clearing any charset-specific internal state.

The default implementation of this method does nothing. This method should be overridden by encoders that maintain internal state.

isLegalReplacement	back to summary
public boolean isLegalReplacement(byte[] repl) Overrides java.nio.charset.CharsetEncoder.isLegalReplacement. Doc from java.nio.charset.CharsetEncoder.isLegalReplacement. Tells whether or not the given byte array is a legal replacement value for this encoder. A replacement is legal if, and only if, it is a legal sequence of bytes in this encoder's charset; that is, it must be possible to decode the replacement into one or more sixteen-bit Unicode characters. The default implementation of this method is not very efficient; it should generally be overridden to improve performance.

isLegalReplacement

back to summary

public boolean isLegalReplacement(byte[] repl)

Overrides java.nio.charset.CharsetEncoder.isLegalReplacement.

Doc from java.nio.charset.CharsetEncoder.isLegalReplacement.

Tells whether or not the given byte array is a legal replacement value for this encoder.

A replacement is legal if, and only if, it is a legal sequence of bytes in this encoder's charset; that is, it must be possible to decode the replacement into one or more sixteen-bit Unicode characters.

The default implementation of this method is not very efficient; it should generally be overridden to improve performance.

public Class AWTCharset

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class AWTCharset.Decoder

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class AWTCharset.Encoder

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail