Класс LineNumberInputStream

public LineNumberInputStream(InputStream in)

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

public int read() throws IOException

Считывает следующий байт данных из этого потока ввода. Значение байта возвращается как целое число в диапазоне 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 байтов, позволяет внешнему коду сбросить поток и попробовать другой анализатор.