Класс SequenceInputStream

java.lang.Object

java.io.InputStream

java.io.SequenceInputStream

Все реализованные интерфейсы:: Closeable, AutoCloseable

public class SequenceInputStream extends InputStream

A SequenceInputStream представляет собой логическое объединение других потоков ввода. Он начинается с упорядоченного набора потоков ввода и считывает из первого, пока не будет достигнут конец файла, после чего он считывает из второго и так далее, пока не будет достигнут конец файла в последнем из содержащихся потоков ввода.

С:: 1.0

Краткое описание конструкторов

Конструктор	Описание
`SequenceInputStream(InputStream s1, InputStream s2)`	Инициализирует новый созданный `SequenceInputStream`, запоминая два аргумента, которые будут читаться в порядке: сначала `s1` и затем `s2`, чтобы предоставить байты, которые должны быть прочитаны из этого `SequenceInputStream`.
`SequenceInputStream(Enumeration<? extends InputStream> e)`	Инициализирует новый созданный `SequenceInputStream`, запоминая аргумент, который должен быть `Enumeration`, генерирующим объекты, тип времени выполнения которых `InputStream`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`int`	`available()`	Возвращает оценку количества байтов, которые могут быть прочитаны (или пропущены) из текущего базового потока ввода без блокировки до следующего вызова метода для текущего базового потока ввода. Следующий вызов может быть выполнен той же нитью или другой нитью. Одно чтение или пропуск такого количества байтов не будет блокировать, но может прочитать или пропустить меньше байтов. Этот метод просто вызывает `available` текущего базового потока ввода и возвращает результат.
`void`	`close()`	Закрывает этот поток ввода и освобождает любые системные ресурсы, связанные с потоком.
`int`	`read()`	Читает следующий байт данных из этого потока ввода.
`int`	`read(byte[] b, int off, int len)`	Читает до `len` байт данных из этого потока ввода в массив байтов.

Методы, объявленные в классе java.io.InputStream

mark, markSupported, nullInputStream, read, readAllBytes, readNBytes, readNBytes, reset, skip, skipNBytes, transferTo

Методы, объявленные в классе java.lang.Object

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

Подробное описание конструкторов

SequenceInputStream

public SequenceInputStream(Enumeration<? extends InputStream> e)

Инициализирует новый созданный SequenceInputStream, запоминая аргумент, который должен быть Enumeration, генерирующим объекты, тип времени выполнения которых InputStream. Потоки ввода, генерируемые перечислением, будут считываться в порядке, чтобы предоставить байты, которые должны быть прочитаны из этого SequenceInputStream. После того, как каждый поток ввода из перечисления исчерпан, он закрывается с помощью метода close.

Параметры:

e - перечисление потоков ввода.

См. также:

Enumeration

SequenceInputStream

public SequenceInputStream(InputStream s1, InputStream s2)

Инициализирует новый созданный SequenceInputStream, запоминая два аргумента, которые будут считываться в порядке: сначала s1 и затем s2, чтобы предоставить байты, которые должны быть прочитаны из этого SequenceInputStream.

Параметры:: s1 - первый поток ввода для чтения.; s2 - второй поток ввода для чтения.

Подробное описание методов

available

public int available() throws IOException

Возвращает оценку количества байтов, которые могут быть прочитаны (или пропущены) из текущего базового потока ввода без блокировки до следующего вызова метода для текущего базового потока ввода. Следующий вызов может быть выполнен той же нитью или другой нитью. Одно чтение или пропуск такого количества байтов не будет блокировать, но может прочитать или пропустить меньше байтов.

Этот метод просто вызывает available текущего базового потока ввода и возвращает результат.

Переопределяет:: available в классе InputStream
Возвращает:: оценку количества байтов, которые могут быть прочитаны (или пропущены) из текущего базового потока ввода без блокировки или 0 если этот поток ввода был закрыт с помощью метода close()
Исключения:: IOException - если произошла ошибка ввода-вывода.
С:: 1.1

read

public int read() throws IOException

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

Этот метод пытается прочитать один символ из текущего подпотока. Если он достигает конца потока, он вызывает метод close текущего подпотока и начинает чтение из следующего подпотока.

Указано в:: read в классе InputStream
Возвращает:: следующий байт данных или -1 если достигнут конец потока.
Исключения:: IOException - если произошла ошибка ввода-вывода.

read

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

Читает до len байт данных из этого потока ввода в массив байтов. Если len не равно нулю, метод блокируется, пока не станет доступным по крайней мере 1 байт ввода; в противном случае байты не читаются, и возвращается 0.

Метод read класса SequenceInputStream пытается прочитать данные из текущего подпотока. Если он не удается прочитать символы, потому что подпоток достиг конца потока, он вызывает метод close текущего подпотока и начинает чтение из следующего подпотока.

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

read в классе InputStream

Параметры:

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

off - начальный смещение в массиве b, в котором данные записываются.

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

Возвращает:

количество считанных байтов.

Исключения:

NullPointerException - Если b равно null.

IndexOutOfBoundsException - Если off отрицательно, len отрицательно или len больше, чем b.length - off

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

См. также:

InputStream.read()

close

public void close() throws IOException

Закрывает этот поток ввода и освобождает любые системные ресурсы, связанные с потоком. Закрытый SequenceInputStream не может выполнять операции ввода и не может быть повторно открыт.

Если этот поток был создан из перечисления, все оставшиеся элементы запрашиваются из перечисления и закрываются, прежде чем метод close вернет значение.

Указано в:: close в интерфейсе AutoCloseable
Указано в:: close в интерфейсе Closeable
Переопределяет:: close в классе InputStream
Исключения:: IOException - если произошла ошибка ввода-вывода.

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/io/SequenceInputStream.html