Struct Octets 

pub struct Octets<'a> { /* private fields */ }

Borrowed logical octets with independently accounted segment metadata.

Primitive content stays inline and allocates no catalogue. Constructed BER content retains its original disjoint ranges, flattened only as metadata. The catalogue can outlive the producing reader; its bytes remain borrowed.

Implementations

impl Octets<'_>

pub fn with_nested_reader<R, E>( &self, parent: &Reader<'_>, encoding: Encoding, field: &'static str, callback: impl for<'scope> FnOnce(&mut Reader<'scope>, &SourceMap) -> Result<R, E>, ) -> Result<R, ContentError<E>>

Decodes carried bytes without letting a temporary joined buffer escape.

One fragment is borrowed; several are explicitly materialized. The original parser, carrying depth, cumulative local ceiling and current aggregate execution survive. R and E cannot borrow the scoped reader, model or joined bytes. Owned outputs must admit their own retained copies. Mapping metadata and joins are admitted before invoking the callback. The content must use original document coordinates. For content decoded inside a scoped mapped reader, use Self::with_nested_reader_mapped.

pub fn with_nested_reader_mapped<R, E>( &self, parent: &Reader<'_>, source: &SourceMap, encoding: Encoding, field: &'static str, callback: impl for<'scope> FnOnce(&mut Reader<'scope>, &SourceMap) -> Result<R, E>, ) -> Result<R, ContentError<E>>

Decodes content inside an existing source context, composing provenance.

Supply the context that produced this content. Parent logical ranges are flattened to actual physical ranges before any callback; retained errors borrow neither the parent map nor its temporary buffer. Even a borrowed single piece can have disjoint physical provenance. The carrier is a physical enclosure including gaps, not a fabricated contiguous encoding.

impl<'a> Octets<'a>

pub fn read( parent: &Reader<'a>, element: &Element<'a>, field: &'static str, ) -> Result<Self>

Reads an OCTET STRING using the original parser’s encoding and ceilings.

X.690 §8.7 permits constructed BER strings composed of OCTET STRING fragments. The iterative traversal preserves inherited depth and source positions, admitting frame/catalogue growth before allocation. A DER reader still refuses constructed forms under its own encoding contract. https://www.itu.int/rec/T-REC-X.690-202102-I/en

pub fn pieces(&self) -> &[Piece<'a>]

The original primitive content ranges in logical order.

pub fn len(&self) -> usize

The logical octet count, recorded during parsing without a later scan.

pub fn is_empty(&self) -> bool

Whether the logical content is empty, including constructed empty input.

pub fn span(&self) -> Span

The original whole carrying element, including its tag and length.

pub fn as_one(&self) -> Option<&'a [u8]>

The borrowed bytes when the logical value occupies one original range.

pub fn copy_in( &self, parent: &Reader<'_>, field: &'static str, at: u64, ) -> Result<OwnedVec<u8>>

Copies logical content into independently retained accounted storage.

This is an explicit materialization; inspection can keep using borrowed ranges, and an already owned result should be moved instead of copied. The original producing session is required before any admission or scan. Metadata traversal, exact capacity and each copy use both its local and current aggregate ceilings. The result retains charge after reader drop. field and at locate the actual enclosing operation, including an empty constructed value. Refusal releases partial output, not the source.

Trait Implementations

impl<'a> Debug for Octets<'a>

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

Formats the value using the given formatter.

impl Source for &Octets<'_>

type Error = SourceError

The original acquisition failure, distinct from a signature mismatch.

fn stream<W: Work>( &mut self, receiver: &mut impl Receiver, execution: &W, ) -> Result<(), Self::Error>

Feeds every chunk once, returning an error for an incomplete source.