Package libcore.io

Class StrictLineReader

java.lang.Object

libcore.io.StrictLineReader

All Implemented Interfaces:

Closeable, AutoCloseable

public class StrictLineReader
extends Object
implements Closeable

Buffers input from an InputStream for reading lines. This class is used for buffered reading of lines. For purposes of this class, a line ends with "\n" or "\r\n". End of input is reported by throwing EOFException. Unterminated line at end of input is invalid and will be ignored, the caller may use hasUnterminatedLine() to detect it after catching the EOFException. This class is intended for reading input that strictly consists of lines, such as line-based cache entries or cache journal. Unlike the BufferedReader which in conjunction with InputStreamReader provides similar functionality, this class uses different end-of-input reporting and a more restrictive definition of a line. This class supports only charsets that encode '\r' and '\n' as a single byte with value 13 and 10, respectively, and the representation of no other character contains these values. We currently check in constructor that the charset is one of US-ASCII, UTF-8 and ISO-8859-1. The default charset is US_ASCII.

Constructor Summary

Constructors

Constructor	Description
StrictLineReader(InputStream in)	Constructs a new StrictLineReader with the default capacity and charset.
StrictLineReader(InputStream in, int capacity)	Constructs a new LineReader with the specified capacity and the default charset.
StrictLineReader(InputStream in, int capacity, Charset charset)	Constructs a new LineReader with the specified capacity and charset.
StrictLineReader(InputStream in, Charset charset)	Constructs a new LineReader with the specified charset and the default capacity.

Method Summary

Modifier and Type	Method	Description
void	close()	Closes the reader by closing the underlying InputStream and marking this reader as closed.
boolean	hasUnterminatedLine()	Check whether there was an unterminated line at end of input after the line reader reported end-of-input with EOFException.
int	readInt()	Read an int from a line containing its decimal representation.
String	readLine()	Reads the next line.

Methods inherited from class java.lang.Object

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

Constructor Detail

StrictLineReader

public StrictLineReader(InputStream in)

Constructs a new StrictLineReader with the default capacity and charset.

Parameters:

in - the InputStream to read data from.

Throws:

NullPointerException - if in is null.

StrictLineReader

public StrictLineReader(InputStream in,
                        int capacity)

Constructs a new LineReader with the specified capacity and the default charset.

Parameters:

in - the InputStream to read data from.

capacity - the capacity of the buffer.

Throws:

NullPointerException - if in is null.

IllegalArgumentException - for negative or zero capacity.

StrictLineReader

public StrictLineReader(InputStream in,
                        Charset charset)

Constructs a new LineReader with the specified charset and the default capacity.

Parameters:

in - the InputStream to read data from.

charset - the charset used to decode data. Only US-ASCII, UTF-8 and ISO-8859-1 is supported.

Throws:

NullPointerException - if in or charset is null.

IllegalArgumentException - if the specified charset is not supported.

StrictLineReader

public StrictLineReader(InputStream in,
                        int capacity,
                        Charset charset)

Constructs a new LineReader with the specified capacity and charset.

Parameters:

in - the InputStream to read data from.

capacity - the capacity of the buffer.

charset - the charset used to decode data. Only US-ASCII, UTF-8 and ISO-8859-1 is supported.

Throws:

NullPointerException - if in or charset is null.

IllegalArgumentException - if capacity is negative or zero or the specified charset is not supported.

Method Detail

close

public void close()
           throws IOException

Closes the reader by closing the underlying InputStream and marking this reader as closed.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException - for errors when closing the underlying InputStream.

readLine

public String readLine()
                throws IOException

Reads the next line. A line ends with "\n" or "\r\n", this end of line marker is not included in the result.

Returns:

the next line from the input.

Throws:

IOException - for underlying InputStream errors.

EOFException - for the end of source stream.

readInt

public int readInt()
            throws IOException

Read an int from a line containing its decimal representation.

Returns:

the value of the int from the next line.

Throws:

IOException - for underlying InputStream errors or conversion error.

EOFException - for the end of source stream.

hasUnterminatedLine

public boolean hasUnterminatedLine()

Check whether there was an unterminated line at end of input after the line reader reported end-of-input with EOFException. The value is meaningless in any other situation.

Returns:

true if there was an unterminated line at end of input.