Package com.sun.tools.javac.parser

Class UnicodeReader

java.lang.Object

com.sun.tools.javac.parser.UnicodeReader

public class UnicodeReader
extends Object

The char reader used by the javac lexer/tokenizer. Returns the sequence of characters contained in the input stream, handling unicode escape accordingly. Additionally, it provides features for saving chars into a buffer and to retrieve them at a later stage.

This is NOT part of any supported API. If you write code that depends on this, you do so at your own risk. This code and its internal interfaces are subject to change or deletion without notice.

Field Summary

Fields

Modifier and Type	Field and Description
protected int	bp
protected char[]	buf The input buffer, index of next character to be read, index of one past last character in buffer.
protected int	buflen
protected char	ch The current character.
protected Log	log
protected Names	names
protected char[]	sbuf A character buffer for saved chars.
protected int	sp
protected int	unicodeConversionBp The buffer index of the last converted unicode character

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	UnicodeReader(ScannerFactory sf, char[] input, int inputLength)
protected	UnicodeReader(ScannerFactory sf, CharBuffer buffer) Create a scanner from the input array.

Method Summary

Modifier and Type	Method and Description
protected void	convertUnicode() Convert unicode escape; bp points to initial '\' character (Spec 3.3).
protected int	digit(int pos, int base) Convert an ASCII digit from its base (8, 10, or 16) to its value.
char[]	getRawCharacters() Returns a copy of the input buffer, up to its inputLength.
char[]	getRawCharacters(int beginIndex, int endIndex) Returns a copy of a character array subset of the input buffer.
protected boolean	isUnicode()
protected char	peekChar()
protected void	putChar(boolean scan)
protected void	putChar(char ch)
protected void	putChar(char ch, boolean scan) Append a character to sbuf.
protected void	scanChar() Read next character.
protected void	scanCommentChar() Read next character in comment, skipping over double '\' characters.
protected char	scanSurrogates() Scan surrogate pairs.
protected void	skipChar()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

buf

protected char[] buf

The input buffer, index of next character to be read, index of one past last character in buffer.

bp

protected int bp

buflen

protected final int buflen

ch

protected char ch

The current character.

unicodeConversionBp

protected int unicodeConversionBp

The buffer index of the last converted unicode character

log

protected Log log

names

protected Names names

sbuf

protected char[] sbuf

A character buffer for saved chars.

sp

protected int sp

Constructor Detail

UnicodeReader

protected UnicodeReader(ScannerFactory sf,
                        CharBuffer buffer)

Create a scanner from the input array. This method might modify the array. To avoid copying the input array, ensure that inputLength < input.length or input[input.length -1] is a white space character.

Parameters:

sf - the factory which created this Scanner

buffer - the input, might be modified Must be positive and less than or equal to input.length.

UnicodeReader

protected UnicodeReader(ScannerFactory sf,
                        char[] input,
                        int inputLength)

Method Detail

scanChar

protected void scanChar()

Read next character.

scanCommentChar

protected void scanCommentChar()

Read next character in comment, skipping over double '\' characters.

putChar

protected void putChar(char ch,
                       boolean scan)

Append a character to sbuf.

putChar

protected void putChar(char ch)

putChar

protected void putChar(boolean scan)

convertUnicode

protected void convertUnicode()

Convert unicode escape; bp points to initial '\' character (Spec 3.3).

scanSurrogates

protected char scanSurrogates()

Scan surrogate pairs. If 'ch' is a high surrogate and the next character is a low surrogate, then put the low surrogate in 'ch', and return the high surrogate. otherwise, just return 0.

digit

protected int digit(int pos,
                    int base)

Convert an ASCII digit from its base (8, 10, or 16) to its value.

isUnicode

protected boolean isUnicode()

skipChar

protected void skipChar()

peekChar

protected char peekChar()

getRawCharacters

public char[] getRawCharacters()

Returns a copy of the input buffer, up to its inputLength. Unicode escape sequences are not translated.

getRawCharacters

public char[] getRawCharacters(int beginIndex,
                               int endIndex)

Returns a copy of a character array subset of the input buffer. The returned array begins at the beginIndex and extends to the character at index endIndex - 1. Thus the length of the substring is endIndex-beginIndex. This behavior is like String.substring(beginIndex, endIndex). Unicode escape sequences are not translated.

Parameters:

beginIndex - the beginning index, inclusive.

endIndex - the ending index, exclusive.

Throws:

ArrayIndexOutOfBoundsException - if either offset is outside of the array bounds