aalto-xml 1.3.2 · com.fasterxml.aalto.in.Utf32Reader

Field Summary

Modifier and Type	Field and Description
protected final boolean	mBigEndian
protected byte[]	mBuffer
protected int	mByteCount Total read byte count; used for error reporting purposes
protected int	mCharCount Total read character count; used for error reporting purposes
protected final ReaderConfig	mConfig
protected InputStream	mIn
protected int	mLength
protected int	mPtr
protected char	mSurrogate Although input is fine with full Unicode set, Java still uses 16-bit chars, so we may have to split high-order chars into surrogate pairs.
pack-priv char[]	mTmpBuf
private static final char	NULL_CHAR

Inherited from java.io.Reader:: lock

Constructor Summary

Access	Constructor and Description
public	Utf32Reader(ReaderConfig cfg, InputStream in, byte[] buf, int ptr, int len, boolean isBigEndian)

Method Summary

Modifier and Type	Method and Description
public void	close() Implements abstract java.io.Reader.close. Implements java.io.Closeable.close. Closes the stream and releases any system resources associated with it.
public final void	freeBuffers()
private boolean	Returns: True, if enough bytes were read to allow decoding of at least one full character; false if EOF was encountered instead. loadMore(int Number of "unused" bytes in the input buffer available)
public int	read() Overrides java.io.Reader.read. Although this method is implemented by the base class, AND it should never be called by Woodstox code, let's still implement it bit more efficiently just in case
public int	read(char[] Destination buffer cbuf, int Offset at which to start storing characters start, int Maximum number of characters to read len) Implements abstract java.io.Reader.read. Reads characters into a portion of an array.
protected void	reportBounds(char[] cbuf, int start, int len)
private void	reportInvalid(int value, int offset, String msg)
protected void	reportStrangeStream()
private void	reportUnexpectedEOF(int gotBytes, int needed)

Inherited from java.io.Reader:: mark markSupported nullReader read read ready reset skip transferTo

Field Detail

mBigEndian	back to summary
protected final boolean mBigEndian

mBuffer	back to summary
protected byte[] mBuffer

mByteCount	back to summary
protected int mByteCount Total read byte count; used for error reporting purposes

mCharCount	back to summary
protected int mCharCount Total read character count; used for error reporting purposes

mConfig	back to summary
protected final ReaderConfig mConfig

mIn	back to summary
protected InputStream mIn

mLength	back to summary
protected int mLength

mPtr	back to summary
protected int mPtr

mSurrogate	back to summary
protected char mSurrogate Although input is fine with full Unicode set, Java still uses 16-bit chars, so we may have to split high-order chars into surrogate pairs.

mTmpBuf	back to summary
pack-priv char[] mTmpBuf

NULL_CHAR	back to summary
private static final char NULL_CHAR

Constructor Detail

Utf32Reader	back to summary
public Utf32Reader(ReaderConfig cfg, InputStream in, byte[] buf, int ptr, int len, boolean isBigEndian)

Method Detail

close	back to summary
public void close() throws IOException Implements abstract java.io.Reader.close. Implements java.io.Closeable.close. Doc from java.io.Reader.close. Closes the stream and releases any system resources associated with it. Once the stream has been closed, further read(), ready(), mark(), reset(), or skip() invocations will throw an IOException. Closing a previously closed stream has no effect. Annotations @Override Exceptions IOException: If an I/O error occurs

back to summary

public void close() throws IOException

Implements abstract java.io.Reader.close.

Implements java.io.Closeable.close.

Doc from java.io.Reader.close.

Closes the stream and releases any system resources associated with it. Once the stream has been closed, further read(), ready(), mark(), reset(), or skip() invocations will throw an IOException. Closing a previously closed stream has no effect.

Annotations

@Override

Exceptions

IOException:: If an I/O error occurs

freeBuffers	back to summary
public final void freeBuffers()

loadMore	back to summary
private boolean loadMore(int available) throws IOException Parameters available:int Number of "unused" bytes in the input buffer Returns:boolean True, if enough bytes were read to allow decoding of at least one full character; false if EOF was encountered instead.

read back to summary

read	back to summary
public int read() throws IOException Overrides java.io.Reader.read. Although this method is implemented by the base class, AND it should never be called by Woodstox code, let's still implement it bit more efficiently just in case Returns:int Doc from java.io.Reader.read. The character read, as an integer in the range 0 to 65535 (`0x00-0xffff`), or -1 if the end of the stream has been reached Annotations @Override Exceptions IOException: Doc from java.io.Reader.read. If an I/O error occurs

public int read() throws IOException

Overrides java.io.Reader.read.

Although this method is implemented by the base class, AND it should never be called by Woodstox code, let's still implement it bit more efficiently just in case

Returns:int

Doc from java.io.Reader.read.

The character read, as an integer in the range 0 to 65535 (0x00-0xffff), or -1 if the end of the stream has been reached

Annotations

@Override

Exceptions

IOException:

Doc from java.io.Reader.read.

If an I/O error occurs

read back to summary

read	back to summary
public int read(char[] cbuf, int start, int len) throws IOException Implements abstract java.io.Reader.read. Doc from java.io.Reader.read. Reads characters into a portion of an array. This method will block until some input is available, an I/O error occurs, or the end of the stream is reached. If `len` is zero, then no characters are read and `0` is returned; otherwise, there is an attempt to read at least one character. If no character is available because the stream is at its end, the value `-1` is returned; otherwise, at least one character is read and stored into `cbuf`. Parameters cbuf:char[] Destination buffer start:int Offset at which to start storing characters len:int Maximum number of characters to read Returns:int The number of characters read, or -1 if the end of the stream has been reached Annotations @Override Exceptions IOException: If an I/O error occurs

public int read(char[] cbuf, int start, int len) throws IOException

Implements abstract java.io.Reader.read.

Doc from java.io.Reader.read.

Reads characters into a portion of an array. This method will block until some input is available, an I/O error occurs, or the end of the stream is reached.

If len is zero, then no characters are read and 0 is returned; otherwise, there is an attempt to read at least one character. If no character is available because the stream is at its end, the value -1 is returned; otherwise, at least one character is read and stored into cbuf.

Parameters

cbuf:char[]: Destination buffer
start:int: Offset at which to start storing characters
len:int: Maximum number of characters to read

Returns:int

The number of characters read, or -1 if the end of the stream has been reached

Annotations

@Override

Exceptions

IOException:: If an I/O error occurs

reportBounds	back to summary
protected void reportBounds(char[] cbuf, int start, int len) throws IOException

reportInvalid	back to summary
private void reportInvalid(int value, int offset, String msg) throws IOException

reportStrangeStream	back to summary
protected void reportStrangeStream() throws IOException

reportUnexpectedEOF	back to summary
private void reportUnexpectedEOF(int gotBytes, int needed) throws IOException

public Class Utf32Reader

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail