Класс LineNumberInputStream

public LineNumberInputStream(InputStream in)

Создаёт поток входных данных с номерами строк, который считывает входные данные из указанного потока.

public int read() throws IOException

Считывает следующий байт данных из этого потока входных данных. Значение байта возвращается как int в диапазоне 0 до 255. Если байт недоступен, потому что достигнут конец потока, возвращается значение -1. Этот метод блокируется до тех пор, пока данные ввода не станут доступны, не будет обнаружен конец потока или не будет выброшено исключение.

Метод read класса LineNumberInputStream вызывает метод read базового потока входных данных. Он проверяет наличие символов возврата каретки и символов новой строки в вводе и соответственно изменяет текущий номер строки. Символ возврата каретки или символ возврата каретки, за которым следует символ новой строки, оба преобразуются в один символ новой строки.

public int read(byte[] b, int off, int len) throws IOException

Считывает до len байтов данных из этого потока входных данных в массив байтов. Этот метод блокируется до тех пор, пока не появятся какие-либо входные данные.

Метод read класса LineNumberInputStream многократно вызывает метод read без аргументов для заполнения массива байтов.

public long skip(long n) throws IOException

Пропускает и отбрасывает n байтов данных из этого потока входных данных. Метод skip может по разным причинам пропустить меньшее количество байтов, возможно, 0. Возвращается фактическое количество пропущенных байтов. Если n отрицательно, байты не пропускаются.

Метод skip класса LineNumberInputStream создаёт массив байтов, а затем многократно считывает в него данные до тех пор, пока не будет прочитано n байтов или не будет достигнут конец потока.

public void setLineNumber(int lineNumber)

Устанавливает номер строки на указанное значение.

public int getLineNumber()

Возвращает текущий номер строки.

public int available() throws IOException

Возвращает количество байтов, которые могут быть прочитаны из этого потока входных данных без блокировки.

Обратите внимание, что если базовый поток входных данных может предоставить k символов ввода без блокировки, LineNumberInputStream может гарантировать предоставление только k/2 символов без блокировки, потому что k символов из базового потока входных данных могут состоять из k/2 пар '\r' и '\n', которые преобразуются в всего k/2 '\n' символа.

public void mark(int readlimit)

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

Метод mark класса LineNumberInputStream запоминает текущий номер строки в частной переменной, а затем вызывает метод mark базового потока входных данных.

public void reset() throws IOException

Перемещает этот поток в положение, которое было в то время, когда метод mark был в последний раз вызван для этого потока входных данных.

Метод reset класса LineNumberInputStream устанавливает номер строки в номер строки в момент вызова метода mark, а затем вызывает метод reset базового потока входных данных.

Метки потока предназначены для использования в ситуациях, когда вам нужно немного прочитать вперёд, чтобы увидеть, что находится в потоке. Часто это проще всего сделать, вызвав какой-либо общий парсер. Если поток обрабатывается парсером, он просто спокойно работает дальше. Если поток не относится к тому типу, который обрабатывает парсер, парсер должен выбросить исключение при сбое, что, если это произойдёт в пределах байтов readlimit, позволяет внешнему коду восстановить поток и попробовать другой парсер.