Класс LineNumberReader

public class LineNumberReader
extends BufferedReader

Буферизованный символьный входной поток, который отслеживает номера строк. Этот класс определяет методы setLineNumber(int) и getLineNumber() для установки и получения текущего номера строки соответственно.

По умолчанию нумерация строк начинается с 0. Это число увеличивается при каждом разделителе строки по мере считывания данных и может быть изменено вызовом setLineNumber(int). Однако обратите внимание, что setLineNumber(int) фактически не изменяет текущую позицию в потоке; он только изменяет значение, которое будет возвращено getLineNumber().

Строка считается разделителем любым из следующих символов: символ новой строки ('\n'), символ возврата каретки ('\r') или символ возврата каретки, за которым сразу следует символ новой строки.

Конструкторы

LineNumberReader

public LineNumberReader(Reader in)

Создает новый читатель с нумерацией строк, используя размер буфера по умолчанию.

Параметры:

in - Объект Reader, предоставляющий базовый поток

LineNumberReader

public LineNumberReader(Reader in,
                        int sz)

Создает новый читатель с нумерацией строк, считывающий символы в буфер заданного размера.

Параметры:

in - Объект Reader, предоставляющий базовый поток

sz - Целое число, задающее размер буфера

Методы

setLineNumber

public void setLineNumber(int lineNumber)

Установить текущий номер строки.

Параметры:

lineNumber - Целое число, задающее номер строки

См. также:

getLineNumber()

getLineNumber

public int getLineNumber()

Получить текущий номер строки.

Возвращает:

Текущий номер строки

См. также:

setLineNumber(int)

read

public int read()
         throws IOException

Прочитать один символ. Разделители строк сжимаются в один символ новой строки ('\n'). При чтении разделителя строки текущий номер строки увеличивается.

Переопределяет:

read в классе BufferedReader

Возвращает:

Прочитанный символ или -1, если достигнут конец потока

Исключения:

IOException - Если произошла ошибка ввода-вывода

read

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

Прочитать символы в часть массива. При чтении разделителя строки текущий номер строки увеличивается.

Переопределяет:

read в классе BufferedReader

Параметры:

cbuf - Буфер назначения

off - Смещение, с которого начинать сохранение символов

len - Максимальное количество символов для чтения

Возвращает:

Количество прочитанных байтов или -1, если конец потока уже достигнут

Исключения:

IOException - Если произошла ошибка ввода-вывода

readLine

public String readLine()
                throws IOException

Прочитать строку текста. При чтении разделителя строки текущий номер строки увеличивается.

Переопределяет:

readLine в классе BufferedReader

Возвращает:

Строка, содержащая содержимое строки, не включая символы завершения строки, или null, если достигнут конец потока

Исключения:

IOException - Если произошла ошибка ввода-вывода

См. также:

Files.readAllLines(java.nio.file.Path, java.nio.charset.Charset)

skip

public long skip(long n)
          throws IOException

Пропустить символы.

Переопределяет:

skip в классе BufferedReader

Параметры:

n - Количество символов для пропуска

Возвращает:

Количество фактически пропущенных символов

Исключения:

IOException - Если произошла ошибка ввода-вывода

IllegalArgumentException - Если n отрицательно

mark

public void mark(int readAheadLimit)
          throws IOException

Пометить текущую позицию в потоке. Последующие вызовы reset() попытаются переместить поток в эту точку, а также соответствующим образом сбросят номер строки.

Переопределяет:

mark в классе BufferedReader

Параметры:

readAheadLimit - Ограничение на количество символов, которое может быть прочитано при сохранении метки. После чтения этого количества символов попытка сбросить поток может завершиться неудачей.

Исключения:

IOException - Если произошла ошибка ввода-вывода

reset

public void reset()
           throws IOException

Сбросить поток до последней метки.

Переопределяет:

reset в классе BufferedReader

Исключения:

IOException - Если поток не помечен или метка была аннулирована