Modifier and Type	Class and Description
private static class	US_ASCII.Decoder
private static class	US_ASCII.Encoder

Modifier and Type	Field and Description
public static final US_ASCII	INSTANCE
private static final JavaLangAccess	JLA

Access	Constructor and Description
public	US_ASCII()

Modifier and Type	Method and Description
public boolean	contains(Charset The given charset cs) Implements abstract java.nio.charset.Charset.contains. Tells whether or not this charset contains the given charset.
public String	historicalName() Implements sun.nio.cs.HistoricallyNamedCharset.historicalName.
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.

INSTANCE	back to summary
public static final US_ASCII INSTANCE

JLA	back to summary
private static final JavaLangAccess JLA

US_ASCII	back to summary
public US_ASCII()

Method Detail

contains back to summary

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. Parameters cs:Charset The given charset Returns:boolean `true` if the given charset is contained in this charset

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.

Parameters

cs:Charset: The given charset

Returns:boolean

true if the given charset is contained in this charset

historicalName	back to summary
public String historicalName() Implements sun.nio.cs.HistoricallyNamedCharset.historicalName.

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. Returns:CharsetDecoder A new decoder for 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.

Returns:CharsetDecoder: 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. Returns:CharsetEncoder A new encoder 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.

Returns:CharsetEncoder: A new encoder for this charset

sun.nio.cs back to summary

private Class US_ASCII.Decoder

Class Inheritance

extends CharsetDecoder

Constructor Summary

Access	Constructor and Description
private	Decoder(Charset cs)

Method Summary

Modifier and Type	Method and Description
private CoderResult	decodeArrayLoop(ByteBuffer src, CharBuffer dst)
private CoderResult	decodeBufferLoop(ByteBuffer src, CharBuffer dst)
protected CoderResult	decodeLoop(ByteBuffer The input byte buffer src, CharBuffer The output character buffer dst) Implements abstract java.nio.charset.CharsetDecoder.decodeLoop. Decodes one or more bytes into one or more characters.

Constructor Detail

Decoder	back to summary
private Decoder(Charset cs)

Method Detail

decodeArrayLoop	back to summary
private CoderResult decodeArrayLoop(ByteBuffer src, CharBuffer dst)

decodeBufferLoop	back to summary
private CoderResult decodeBufferLoop(ByteBuffer src, CharBuffer dst)

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. Parameters src:ByteBuffer The input byte buffer dst:CharBuffer The output character buffer Returns:CoderResult A coder-result object describing the reason for termination

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.

Parameters

src:ByteBuffer: The input byte buffer
dst:CharBuffer: The output character buffer

Returns:CoderResult

A coder-result object describing the reason for termination

sun.nio.cs back to summary

private Class US_ASCII.Encoder

Class Inheritance

extends CharsetEncoder

Field Summary

Modifier and Type	Field and Description
private final Surrogate.Parser	sgp

Constructor Summary

Access	Constructor and Description
private	Encoder(Charset cs)

Method Summary

Modifier and Type	Method and Description
public boolean	canEncode(char The given character c) Overrides java.nio.charset.CharsetEncoder.canEncode. Tells whether or not this encoder can encode the given character.
private CoderResult	encodeArrayLoop(CharBuffer src, ByteBuffer dst)
private CoderResult	encodeBufferLoop(CharBuffer src, ByteBuffer dst)
protected CoderResult	encodeLoop(CharBuffer The input character buffer src, ByteBuffer The output byte buffer dst) Implements abstract java.nio.charset.CharsetEncoder.encodeLoop. Encodes one or more characters into one or more bytes.
public boolean	isLegalReplacement(byte[] The byte array to be tested repl) Overrides java.nio.charset.CharsetEncoder.isLegalReplacement. Tells whether or not the given byte array is a legal replacement value for this encoder.

Field Detail

sgp	back to summary
private final Surrogate.Parser sgp

Constructor Detail

Encoder	back to summary
private Encoder(Charset cs)

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. Parameters c:char The given character Returns:boolean `true` if, and only if, this encoder can encode the given character

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.

Parameters

c:char: The given character

Returns:boolean

true if, and only if, this encoder can encode the given character

encodeArrayLoop	back to summary
private CoderResult encodeArrayLoop(CharBuffer src, ByteBuffer dst)

encodeBufferLoop	back to summary
private CoderResult encodeBufferLoop(CharBuffer src, ByteBuffer dst)

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. Parameters src:CharBuffer The input character buffer dst:ByteBuffer The output byte buffer Returns:CoderResult A coder-result object describing the reason for termination

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.

Parameters

src:CharBuffer: The input character buffer
dst:ByteBuffer: The output byte buffer

Returns:CoderResult

A coder-result object describing the reason for termination

isLegalReplacement back to summary

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. Parameters repl:byte[] The byte array to be tested Returns:boolean `true` if, and only if, the given byte array is a legal replacement value for this encoder

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.

Parameters

repl:byte[]: The byte array to be tested

Returns:boolean

true if, and only if, the given byte array is a legal replacement value for this encoder

public Class US_ASCII

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class US_ASCII.Decoder

Constructor Summary

Method Summary

Constructor Detail

Method Detail

private Class US_ASCII.Encoder

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail