uk.ac.starlink.ecsv

Class LineReader

java.lang.Object

uk.ac.starlink.ecsv.LineReader

All Implemented Interfaces:

Closeable, AutoCloseable

public abstract class LineReader
extends Object
implements Closeable

Reads lines of text from an input stream.

Since:

28 Apr 2020

Author:

Mark Taylor

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	LineReader(InputStream in) Constructor.

Method Summary

Modifier and Type	Method and Description
void	close()
static LineReader	createArrayLineReader(String[] lines) Returns a LineReader instance that reads lines from an array.
static LineReader	createAsciiLineReader(InputStream in) Returns a LineReader instance that just uses the lower 7 bits of each input byte for character values.
abstract String	readLine() Returns the next non-empty line of text from the input stream.

Methods inherited from class java.lang.Object

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

Constructor Detail

LineReader

protected LineReader(InputStream in)

Constructor.

Parameters:

in - underlying input stream

Method Detail

readLine

public abstract String readLine()
                         throws IOException

Returns the next non-empty line of text from the input stream. The line will not consist of only whitespace.

Returns:

non-blank line, or null if the input is at an end

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

createAsciiLineReader

public static LineReader createAsciiLineReader(InputStream in)

Returns a LineReader instance that just uses the lower 7 bits of each input byte for character values.

Parameters:

in - input stream

Returns:

line reader

createArrayLineReader

public static LineReader createArrayLineReader(String[] lines)

Returns a LineReader instance that reads lines from an array.

Parameters:

lines - line array

Returns:

line reader