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 Details

    • 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 Details

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