Класс 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 байтов, внешний код может восстановить исходную позицию потока и попробовать другой анализатор.