de.lmu.ifi.dbs.elki.utilities.io

Class LineReader

java.lang.Object

de.lmu.ifi.dbs.elki.utilities.io.LineReader

All Implemented Interfaces:

AutoCloseable

public class LineReader
extends Object
implements AutoCloseable

Fast class to read a file, line per line. Lines must be split using Unix newlines \n, linefeeds \r are ignored. This is a rather minimal implementation, which supposedly pays off in performance. In particular, this class allows recycling the buffer, which will yield less object allocations and thus less garbage collection. Usage example:

 StringBuilder buf = new StringBuilder();
 LineReader reader = new LineReader(inputStream);
 // Clear buffer, and append next line.
 while(reader.readLine(buf.delete(0, buf.length()))) {
   // process string in buffer.
 }
 

Author:

Erich Schubert

Field Summary

Fields

Modifier and Type	Field and Description
(package private) char[]	buffer Character buffer
(package private) static int	BUFFER_SIZE Buffer size to use
(package private) int	end Current position, and length of buffer
(package private) Reader	in Input stream to read from
(package private) int	pos Current position, and length of buffer

Constructor Summary

Constructors

Constructor and Description
LineReader(InputStream in) Constructor
LineReader(Reader in) Constructor

Method Summary

Methods

Modifier and Type	Method and Description
void	close()
boolean	readLine(Appendable buf) Read a line into the given buffer.

Methods inherited from class java.lang.Object

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

Field Detail

BUFFER_SIZE

static final int BUFFER_SIZE

Buffer size to use

See Also:

Constant Field Values

in

Reader in

Input stream to read from

buffer

char[] buffer

Character buffer

pos

int pos

Current position, and length of buffer

end

int end

Current position, and length of buffer

Constructor Detail

LineReader

public LineReader(InputStream in)

Constructor

Parameters:

in - Stream

LineReader

public LineReader(Reader in)

Constructor

Parameters:

in - Reader

Method Detail

readLine

public boolean readLine(Appendable buf)
                 throws IOException

Read a line into the given buffer.

Parameters:

buf - Buffer.

Returns:

true if some characters have been read.

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Throws:

IOException