Struct InputBuffer 

pub struct InputBuffer { /* private fields */ }

Bytes to read, however they were obtained.

Implementations

impl InputBuffer

pub fn from_bytes(bytes: Vec<u8>) -> Self

Takes ownership of bytes already in hand.

pub fn from_owner<T>(owner: T) -> Self

where T: AsRef<[u8]> + Debug + Send + Sync + 'static,

Retains stable externally owned bytes without copying their payload.

The owner is held for the complete lifetime of this buffer and every clone. This is the adoption path for language-runtime byte objects and existing immutable buffers whose address remains stable.

pub fn open(path: impl AsRef<Path>, limits: Limits) -> Result<Self, Diagnostic>

Opens and transparently decompresses a bounded local file.

Errors

Returns a registered resource or limit diagnostic.

pub fn from_reader( reader: impl Read, limits: Limits, ) -> Result<Self, Diagnostic>

Reads a bounded stream and transparently decompresses its bytes.

Errors

Returns a registered resource or limit diagnostic.

pub fn as_bytes(&self) -> &[u8]

The bytes.

pub fn len(&self) -> usize

The number of bytes.

pub fn is_empty(&self) -> bool

Returns true when there is nothing to read.

pub const fn kind(&self) -> InputKind

How this buffer owns its bytes.

pub fn origin(&self) -> Option<&str>

Where the bytes came from.

pub fn with_origin(self, origin: &str) -> Self

Names where the bytes came from.

impl InputBuffer

pub fn from_encoded_bytes( bytes: Vec<u8>, limits: Limits, ) -> Result<Self, Diagnostic>

Adopts plain bytes or decodes a gzip/Zstandard container within limits.

Plain bytes retain their allocation. Compressed bytes are decoded directly from the supplied vector; expanded output uses private mapped storage when mmap is enabled. Self::from_bytes deliberately performs no decoding.

use molframe_core::io::{InputBuffer, Limits};
let bytes = b"data_example\n".to_vec();
let pointer = bytes.as_ptr();
let input = InputBuffer::from_encoded_bytes(bytes, Limits::default())?;
assert_eq!(input.as_bytes().as_ptr(), pointer);

Errors

Invalid containers, unavailable decoders, or exceeded byte/expansion limits.

Trait Implementations

impl Clone for InputBuffer

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for InputBuffer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl SourceBytes for InputBuffer

fn window( &mut self, start: u64, len: usize, ) -> Result<ByteWindow<'_>, Diagnostic>

Returns at most len bytes starting at the global byte offset start.

fn len_hint(&self) -> Option<u64>

Exact source length when known without consuming the source.