java.io

Класс LineNumberInputStream

java.lang. Объект

java.io. InputStream

java.io. FilterInputStream

java.io. LineNumberInputStream

Все Реализованные Интерфейсы:

Closeable, AutoCloseable

Осуждаемый.

Этот класс неправильно предполагает, что байты соответственно представляют символы. С JDK 1.1, привилегированный способ работать на символьных потоках через новые символьно-потоковые классы, которые включают класс для того, чтобы считать номера строки.

@Deprecated
public class LineNumberInputStream
extends FilterInputStream

Этот класс является входным потоковым фильтром, который обеспечивает добавленную функциональность отслеживания текущего номера строки.

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

Номер строки начинается в 0, и постепенно увеличивается 1 когда a read возвращает символ новой строки.

С тех пор:

JDK1.0

См. Также:

LineNumberReader

Полевая Сводка

Поля java.io унаследованный от класса. FilterInputStream

в

Сводка конструктора

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

Конструктор и Описание
LineNumberInputStream(InputStream in) Осуждаемый. Создает входной поток числа новой строки, который читает его ввод из указанного входного потока.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
int	available() Осуждаемый. Возвращает число байтов, которые могут быть считаны из этого входного потока без блокирования.
int	getLineNumber() Осуждаемый. Возвращает текущий номер строки.
void	mark(int readlimit) Осуждаемый. Отмечает текущую позицию в этом входном потоке.
int	read() Осуждаемый. Читает следующий байт данных от этого входного потока.
int	read(byte[] b, int off, int len) Осуждаемый. Чтения до len байты данных от этого входного потока в массив байтов.
void	reset() Осуждаемый. Репозиции этот поток к позиции в это время mark метод был последним, обращался к этому входному потоку.
void	setLineNumber(int lineNumber) Осуждаемый. Устанавливает номер строки в указанный параметр.
long	skip(long n) Осуждаемый. Перескакивает и отбрасывает n байты данных от этого входного потока.

Методы java.io унаследованный от класса. FilterInputStream

close, markSupported, read

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

LineNumberInputStream

public LineNumberInputStream(InputStream in)

Осуждаемый.

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

Параметры:

in - базовый входной поток.

Деталь метода

читать

public int read()
         throws IOException

Осуждаемый.

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

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

Переопределения:

read в классе FilterInputStream

Возвраты:

следующий байт данных, или -1 если конец этого потока достигается.

Броски:

IOException - если ошибка ввода-вывода происходит.

См. Также:

FilterInputStream.in, getLineNumber()

читать

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

Осуждаемый.

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

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

Переопределения:

read в классе FilterInputStream

Параметры:

b - буфер, в который читаются данные.

off - смещение запуска данных.

len - максимальное количество байтов читало.

Возвраты:

общее количество чтения байтов в буфер, или -1 если нет больше данных, потому что конец этого потока был достигнут.

Броски:

IOException - если ошибка ввода-вывода происходит.

См. Также:

read()

пропустить

public long skip(long n)
          throws IOException

Осуждаемый.

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

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

Переопределения:

skip в классе FilterInputStream

Параметры:

n - число байтов, которые будут пропущены.

Возвраты:

фактическое число байтов пропускается.

Броски:

IOException - если ошибка ввода-вывода происходит.

См. Также:

FilterInputStream.in

setLineNumber

public void setLineNumber(int lineNumber)

Осуждаемый.

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

Параметры:

lineNumber - число новой строки.

См. Также:

getLineNumber()

getLineNumber

public int getLineNumber()

Осуждаемый.

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

Возвраты:

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

См. Также:

setLineNumber(int)

доступный

public int available()
              throws IOException

Осуждаемый.

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

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

Переопределения:

available в классе FilterInputStream

Возвраты:

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

Броски:

IOException - если ошибка ввода-вывода происходит.

См. Также:

FilterInputStream.in

метка

public void mark(int readlimit)

Осуждаемый.

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

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

Переопределения:

mark в классе FilterInputStream

Параметры:

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

См. Также:

FilterInputStream.in, reset()

сброс

public void reset()
           throws IOException

Осуждаемый.

Репозиции этот поток к позиции в это время mark метод был последним, обращался к этому входному потоку.

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

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

Переопределения:

reset в классе FilterInputStream

Броски:

IOException - если ошибка ввода-вывода происходит.

См. Также:

FilterInputStream.in, mark(int)