APIdia Launch Partner
Top Inners Fields Constructors Methods
sun.nio.cs

public Class US_ASCII

extends Charset
implements HistoricallyNamedCharset
Class Inheritance
All Implemented Interfaces
sun.nio.cs.HistoricallyNamedCharset
Imports
jdk.internal.access.JavaLangAccess, .SharedSecrets, java.nio.ByteBuffer, .CharBuffer, java.nio.charset.Charset, .CharsetDecoder, .CharsetEncoder, .CoderResult

Nested and Inner Type Summary

Modifier and TypeClass and Description
private static class
US_ASCII.Decoder

private static class
US_ASCII.Encoder

Field Summary

Modifier and TypeField and Description
public static final US_ASCII
INSTANCE

private static final JavaLangAccess
JLA

Constructor Summary

AccessConstructor and Description
public
US_ASCII()

Method Summary

Modifier and TypeMethod 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 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.

Inherited from java.nio.charset.Charset:
aliasesavailableCharsetscanEncodecompareTodecodedefaultCharsetdisplayNamedisplayNameencodeencodeequalsforNameforNamehashCodeisRegisteredisSupportednametoString

Field Detail

INSTANCEback to summary
public static final US_ASCII INSTANCE
JLAback to summary
private static final JavaLangAccess JLA

Constructor Detail

US_ASCIIback to summary
public US_ASCII()

Method Detail

containsback 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.

historicalNameback to summary
public String historicalName()

Implements sun.nio.cs.HistoricallyNamedCharset.historicalName.

newDecoderback 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.

newEncoderback 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.

sun.nio.cs back to summary

private Class US_ASCII.Decoder

extends CharsetDecoder
Class Inheritance

Constructor Summary

AccessConstructor and Description
private
Decoder(Charset cs)

Method Summary

Modifier and TypeMethod and Description
private CoderResult
decodeArrayLoop(ByteBuffer src, CharBuffer dst)

private CoderResult
decodeBufferLoop(ByteBuffer src, CharBuffer dst)

protected CoderResult
decodeLoop(ByteBuffer src, CharBuffer dst)

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

Decodes one or more bytes into one or more characters.

Inherited from java.nio.charset.CharsetDecoder:
averageCharsPerBytecharsetdecodedecodedetectedCharsetflushimplFlushimplOnMalformedInputimplOnUnmappableCharacterimplReplaceWithimplResetisAutoDetectingisCharsetDetectedmalformedInputActionmaxCharsPerByteonMalformedInputonUnmappableCharacterreplacementreplaceWithresetunmappableCharacterAction

Constructor Detail

Decoderback to summary
private Decoder(Charset cs)

Method Detail

decodeArrayLoopback to summary
private CoderResult decodeArrayLoop(ByteBuffer src, CharBuffer dst)
decodeBufferLoopback to summary
private CoderResult decodeBufferLoop(ByteBuffer src, CharBuffer dst)
decodeLoopback 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.

sun.nio.cs back to summary

private Class US_ASCII.Encoder

extends CharsetEncoder
Class Inheritance

Field Summary

Modifier and TypeField and Description
private final Surrogate.Parser
sgp

Constructor Summary

AccessConstructor and Description
private
Encoder(Charset cs)

Method Summary

Modifier and TypeMethod 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.

private CoderResult
encodeArrayLoop(CharBuffer src, ByteBuffer dst)

private CoderResult
encodeBufferLoop(CharBuffer src, ByteBuffer dst)

protected CoderResult
encodeLoop(CharBuffer src, ByteBuffer dst)

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

Encodes one or more characters into one or more bytes.

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:
averageBytesPerCharcharsetencodeencodeflushimplFlushimplOnMalformedInputimplOnUnmappableCharacterimplReplaceWithimplResetmalformedInputActionmaxBytesPerCharonMalformedInputonUnmappableCharacterreplacementreplaceWithresetunmappableCharacterAction

Field Detail

sgpback to summary
private final Surrogate.Parser sgp

Constructor Detail

Encoderback to summary
private Encoder(Charset cs)

Method Detail

canEncodeback 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.

canEncodeback 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.

encodeArrayLoopback to summary
private CoderResult encodeArrayLoop(CharBuffer src, ByteBuffer dst)
encodeBufferLoopback to summary
private CoderResult encodeBufferLoop(CharBuffer src, ByteBuffer dst)
encodeLoopback 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.

isLegalReplacementback 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.