Skip to main content

skip_container

Function skip_container 

Source
pub fn skip_container(r: &mut TlvReader<'_>) -> Result<(), ImError>
Expand description

Reader positioned just after a container start: discard the whole sub-tree (used to skip fields we do not consume). Calling this with the reader in any other position yields an error::ImError or misattributed members — never a panic or UB.

Streaming: the skipped bytes are walked structurally (tags, lengths, depth) but never decoded — string payloads in skipped data are not UTF-8 validated — and it does not charge the codec’s tree-builder element budget; a discarded payload is bounded by its input size only. (Deliberate: see the 2026-08-09 performance-remediation spec §3.1.)

§Errors

Propagates any matter_codec::Error from the underlying streaming walk (e.g. UnclosedContainer on truncated input) as error::ImError::Codec.