Класс StreamContainer

Summary: Represents stream container which contains the stream and provides stream processing routines.

Module: aspose.imaging

Full Name: aspose.imaging.StreamContainer

Inheritance: DisposableObject

Constructors

NameDescription
StreamContainer(stream)Инициализирует новый экземпляр класса StreamContainer.
StreamContainer(stream, dispose_stream)Инициализирует новый экземпляр класса StreamContainer.

Properties

NameTypeAccessDescription
READ_WRITE_BYTES_COUNT [static]intrУказывает количество байтов для чтения и записи при последовательном чтении.
can_readboolrВозвращает значение, указывающее, поддерживает ли поток чтение.
can_seekboolrВозвращает значение, указывающее, поддерживает ли поток перемещение.
can_writeboolrВозвращает значение, указывающее, поддерживает ли поток запись.
disposedboolrПолучает значение, указывающее, удалён ли этот экземпляр.
is_stream_disposed_on_closeboolrВозвращает значение, указывающее, будет ли этот поток освобождён при закрытии.
lengthintr/wПолучает или задаёт длину потока в байтах. Это значение меньше, чем позиция начала потока, переданная в конструкторе StreamContainer.
positionintr/wПолучает или задаёт текущую позицию в потоке. Это значение представляет смещение от начальной позиции потока, переданной в конструкторе StreamContainer.
поток_io.BufferedRandomrВозвращает поток данных.
sync_rootSystem.ObjectrВозвращает объект, который можно использовать для синхронизации доступа к синхронизированному ресурсу.

Methods

NameDescription
flush()Очищает все буферы этого потока и заставляет любые буферизованные данные записаться в подлежащие устройство.
read(buffer, offset, count)Читает последовательность байтов из текущего потока и перемещает позицию в потоке на количество прочитанных байтов.
read(bytes)Читает байты, заполняя указанный буфер байтов.
read_byte()Читает один байт из потока и перемещает позицию в потоке на один байт, либо возвращает -1, если достигнут конец потока.
save(destination_stream)Сохраняет (копирует) данные потока в указанный поток. Использует размер буфера по умолчанию StreamContainer.READ_WRITE_BYTES_COUNT и значение потока StreamContainer.length.
save(destination_stream, buffer_size)Сохраняет (копирует) все данные потока в указанный поток. Использует значение потока StreamContainer.length.
save(destination_stream, buffer_size, length)Сохраняет (копирует) данные потока в указанный поток.
save(file_path)Сохраняет (копирует) данные потока в указанный поток. Использует размер буфера по умолчанию StreamContainer.READ_WRITE_BYTES_COUNT и значение потока StreamContainer.length.
save(file_path, buffer_size)Сохраняет (копирует) данные потока в указанный поток. Использует значение потока StreamContainer.length.
save(file_path, buffer_size, length)Сохраняет (копирует) данные потока в указанный поток.
save_to_stream(destination_stream)Сохраняет (копирует) данные потока в указанный поток. Использует размер буфера по умолчанию StreamContainer.READ_WRITE_BYTES_COUNT и значение потока StreamContainer.length.
save_to_stream_with_buf_size(destination_stream, buffer_size)Сохраняет (копирует) все данные потока в указанный поток. Использует значение потока StreamContainer.length.
save_to_stream_with_buf_size_and_len(destination_stream, buffer_size, length)Сохраняет (копирует) данные потока в указанный поток.
save_with_buf_size(file_path, buffer_size)Сохраняет (копирует) данные потока в указанный поток. Использует значение потока StreamContainer.length.
save_with_buf_size_and_len(file_path, buffer_size, length)Сохраняет (копирует) данные потока в указанный поток.
seek(offset, origin)Устанавливает позицию в текущем потоке.
seek_begin()Устанавливает позицию потока в начало потока. Это значение представляет смещение от начальной позиции потока, переданной в конструкторе StreamContainer.
to_bytes()Преобразует данные потока в массив int.
to_bytes(position, bytes_count)Преобразует данные потока в массив int.
write(buffer, offset, count)Записывает последовательность байтов в текущий поток и перемещает текущую позицию в этом потоке на количество записанных байтов.
write(bytes)Записывает все указанные байты в поток.
write_byte(value)Записывает байт в текущую позицию потока и перемещает позицию в потоке на один байт.
write_to(stream_container)Копирует содержащиеся данные в другой StreamContainer.
write_to(stream_container, length)Копирует содержащиеся данные в другой StreamContainer.

Constructor: StreamContainer(stream)

 StreamContainer(stream) 

Инициализирует новый экземпляр класса StreamContainer.

Parameters:

ПараметрТипОписание
поток_io.BufferedRandomПоток.

Constructor: StreamContainer(stream, dispose_stream)

 StreamContainer(stream, dispose_stream) 

Инициализирует новый экземпляр класса StreamContainer.

Parameters:

ПараметрТипОписание
поток_io.BufferedRandomПоток данных.
dispose_streamboolесли установлено в true, поток будет освобождён при освобождении контейнера.

Method: read(buffer, offset, count)

 read(buffer, offset, count) 

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

Parameters:

ПараметрТипОписание
буферSystem.ByteМассив байтов. После возврата этого метода буфер содержит указанный массив байтов, где значения между offset и (offset + count - 1) заменены байтами, прочитанными из текущего источника.
offsetintНулевой байтовый смещение в buffer, с которого начинать сохранять данные, прочитанные из текущего потока.
countintМаксимальное количество байтов, которое будет прочитано из текущего потока.

Returns

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

Method: read(bytes)

 read(bytes) 

Читает байты, заполняя указанный буфер байтов.

Parameters:

ПараметрТипОписание
байтыSystem.ByteБайты для заполнения.

Returns

ТипОписание
intКоличество прочитанных байтов. Это значение может быть меньше количества байтов в буфере, если в потоке недостаточно байтов.

Method: read_byte()

 read_byte() 

Читает один байт из потока и перемещает позицию в потоке на один байт, либо возвращает -1, если достигнут конец потока.

Returns

ТипОписание
intБеззнаковый байт, приведённый к Int32, или -1, если достигнут конец потока.

Method: save(destination_stream)

 save(destination_stream) 

Сохраняет (копирует) данные потока в указанный поток. Использует размер буфера по умолчанию StreamContainer.READ_WRITE_BYTES_COUNT и значение потока StreamContainer.length.

Parameters:

ПараметрТипОписание
destination_stream_io.BufferedRandomПоток, в который сохраняются данные.

Method: save(destination_stream, buffer_size)

 save(destination_stream, buffer_size) 

Сохраняет (копирует) все данные потока в указанный поток. Использует значение потока StreamContainer.length.

Parameters:

ПараметрТипОписание
destination_stream_io.BufferedRandomПоток, в который сохраняются данные.
размер_буфераintБуфер.

Method: save(destination_stream, buffer_size, length)

 save(destination_stream, buffer_size, length) 

Сохраняет (копирует) данные потока в указанный поток.

Parameters:

ПараметрТипОписание
destination_stream_io.BufferedRandomПоток, в который сохраняются данные.
buffer_sizeintРазмер буфера. По умолчанию используется значение StreamContainer.READ_WRITE_BYTES_COUNT.
lengthintДлина данных потока для копирования. По умолчанию длина устанавливается в значение StreamContainer.length.

Method: save(file_path)

 save(file_path) 

Сохраняет (копирует) данные потока в указанный поток. Использует размер буфера по умолчанию StreamContainer.READ_WRITE_BYTES_COUNT и значение потока StreamContainer.length.

Parameters:

ПараметрТипОписание
file_pathstringПуть к файлу, в который сохраняются данные потока.

Method: save(file_path, buffer_size)

 save(file_path, buffer_size) 

Сохраняет (копирует) данные потока в указанный поток. Использует значение потока StreamContainer.length.

Parameters:

ПараметрТипОписание
file_pathstringПуть к файлу, в который сохраняются данные потока.
buffer_sizeintРазмер буфера. По умолчанию используется значение StreamContainer.READ_WRITE_BYTES_COUNT.

Method: save(file_path, buffer_size, length)

 save(file_path, buffer_size, length) 

Сохраняет (копирует) данные потока в указанный поток.

Parameters:

ПараметрТипОписание
file_pathstringПуть к файлу, в который сохраняются данные потока.
buffer_sizeintРазмер буфера. По умолчанию используется значение StreamContainer.READ_WRITE_BYTES_COUNT.
lengthintДлина данных потока для копирования. По умолчанию длина устанавливается в значение StreamContainer.length.

Method: save_to_stream(destination_stream)

 save_to_stream(destination_stream) 

Сохраняет (копирует) данные потока в указанный поток. Использует размер буфера по умолчанию StreamContainer.READ_WRITE_BYTES_COUNT и значение потока StreamContainer.length.

Parameters:

ПараметрТипОписание
destination_stream_io.BufferedRandomПоток, в который сохраняются данные.

Method: save_to_stream_with_buf_size(destination_stream, buffer_size)

 save_to_stream_with_buf_size(destination_stream, buffer_size) 

Сохраняет (копирует) все данные потока в указанный поток. Использует значение потока StreamContainer.length.

Parameters:

ПараметрТипОписание
destination_stream_io.BufferedRandomПоток, в который сохраняются данные.
размер_буфераintБуфер.

Method: save_to_stream_with_buf_size_and_len(destination_stream, buffer_size, length)

 save_to_stream_with_buf_size_and_len(destination_stream, buffer_size, length) 

Сохраняет (копирует) данные потока в указанный поток.

Parameters:

ПараметрТипОписание
destination_stream_io.BufferedRandomПоток, в который сохраняются данные.
buffer_sizeintРазмер буфера. По умолчанию используется значение StreamContainer.READ_WRITE_BYTES_COUNT.
lengthintДлина данных потока для копирования. По умолчанию длина устанавливается в значение StreamContainer.length.

Method: save_with_buf_size(file_path, buffer_size)

 save_with_buf_size(file_path, buffer_size) 

Сохраняет (копирует) данные потока в указанный поток. Использует значение потока StreamContainer.length.

Parameters:

ПараметрТипОписание
file_pathstringПуть к файлу, в который сохраняются данные потока.
buffer_sizeintРазмер буфера. По умолчанию используется значение StreamContainer.READ_WRITE_BYTES_COUNT.

Method: save_with_buf_size_and_len(file_path, buffer_size, length)

 save_with_buf_size_and_len(file_path, buffer_size, length) 

Сохраняет (копирует) данные потока в указанный поток.

Parameters:

ПараметрТипОписание
file_pathstringПуть к файлу, в который сохраняются данные потока.
buffer_sizeintРазмер буфера. По умолчанию используется значение StreamContainer.READ_WRITE_BYTES_COUNT.
lengthintДлина данных потока для копирования. По умолчанию длина устанавливается в значение StreamContainer.length.

Method: seek(offset, origin)

 seek(offset, origin) 

Устанавливает позицию в текущем потоке.

Parameters:

ПараметрТипОписание
offsetintСмещение в байтах относительно параметра origin. Это значение представляет смещение от начальной позиции потока, переданной в конструкторе StreamContainer.
originSeekOriginЗначение типа SeekOrigin, указывающее точку отсчёта, используемую для получения новой позиции.

Returns

ТипОписание
intНовая позиция в текущем потоке.

Method: to_bytes()

 to_bytes() 

Преобразует данные потока в массив int.

Returns

ТипОписание
System.ByteДанные потока, преобразованные в массив int.

Method: to_bytes(position, bytes_count)

 to_bytes(position, bytes_count) 

Преобразует данные потока в массив int.

Parameters:

ПараметрТипОписание
positionintПозиция, с которой начинать чтение байтов.
bytes_countintКоличество байтов для чтения.

Returns

ТипОписание
System.ByteДанные потока, преобразованные в массив int.

Method: write(buffer, offset, count)

 write(buffer, offset, count) 

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

Parameters:

ПараметрТипОписание
буферSystem.ByteМассив байтов. Этот метод копирует count байтов из buffer в текущий поток.
offsetintНулевое байтовое смещение в buffer, с которого начинать копирование байтов в текущий поток.
countintКоличество байтов, которое будет записано в текущий поток.

Method: write(bytes)

 write(bytes) 

Записывает все указанные байты в поток.

Parameters:

ПараметрТипОписание
байтыSystem.ByteБайты для записи.

Method: write_byte(value)

 write_byte(value) 

Записывает байт в текущую позицию потока и перемещает позицию в потоке на один байт.

Parameters:

ПараметрТипОписание
значениеSystem.ByteБайт для записи в поток.

Method: write_to(stream_container)

 write_to(stream_container) 

Копирует содержащиеся данные в другой StreamContainer.

Parameters:

ПараметрТипОписание
stream_containerStreamContainerКонтейнер потока, в который копировать.

Method: write_to(stream_container, length)

 write_to(stream_container, length) 

Копирует содержащиеся данные в другой StreamContainer.

Parameters:

ПараметрТипОписание
stream_containerStreamContainerКонтейнер потока, в который копировать.
lengthintКоличество байтов для записи.