Struct WireBudget 

pub struct WireBudget { /* private fields */ }

Mutable accounting state shared by one complete wire decode.

Implementations

impl WireBudget

pub const fn limits(&self) -> WireLimits

Returns the configured limits for this session.

pub fn check_node(&mut self) -> Result<(), ValueWireDecodeError>

Charges one decoded node.

pub fn check_depth(&self, depth: usize) -> Result<(), ValueWireDecodeError>

Checks a recursive depth.

pub fn check_collection_items( &self, items: usize, ) -> Result<(), ValueWireDecodeError>

Checks one collection length.

pub fn check_map_entries( &self, entries: usize, ) -> Result<(), ValueWireDecodeError>

Checks one map length.

pub fn check_string_bytes( &self, bytes: usize, ) -> Result<(), ValueWireDecodeError>

Checks one decoded string length.

pub fn check_numeric_bytes( &self, bytes: usize, ) -> Result<(), ValueWireDecodeError>

Checks one decoded numeric representation length in UTF-8 bytes.

pub fn check_container( &mut self, container: &ValueContainer, ) -> Result<(), ValueWireDecodeError>

Validates a decoded value container against the shared budget.

pub fn check_container_at( &mut self, container: &ValueContainer, depth: usize, ) -> Result<(), ValueWireDecodeError>

Validates one decoded value container at depth.

pub fn check_value(&mut self, value: &Value) -> Result<(), ValueWireDecodeError>

Validates one scalar Value against the shared budget.

pub fn check_multi_values( &mut self, values: &MultiValues, ) -> Result<(), ValueWireDecodeError>

Validates one homogeneous collection against the shared budget.

Parameters

• values - Collection whose elements are charged to this budget.

Errors

Returns a resource-limit error when the collection exceeds the configured depth, node, item, string, map, or numeric limits.

pub fn check_multi_values_at( &mut self, values: &MultiValues, depth: usize, ) -> Result<(), ValueWireDecodeError>

Validates one homogeneous collection at an embedding depth.

Parameters

• values - Collection whose elements are charged to this budget.
• depth - Root-inclusive depth of the collection.

Errors

Returns a resource-limit error when the collection exceeds the configured depth, node, item, string, map, or numeric limits.

pub fn check_named_value( &mut self, value: &NamedValue, ) -> Result<(), ValueWireDecodeError>

Validates a named scalar and reuses scalar budget accounting.

Parameters

• value - Named scalar to validate.

Errors

Returns a resource-limit error for the wrapper name or nested value.

pub fn check_named_value_at( &mut self, value: &NamedValue, depth: usize, ) -> Result<(), ValueWireDecodeError>

Validates a named scalar at an embedding depth.

Parameters

• value - Named scalar to validate.
• depth - Root-inclusive depth of the named wrapper.

Errors

Returns a resource-limit error for the wrapper name or nested value.

pub fn check_named_multi_values( &mut self, value: &NamedMultiValues, ) -> Result<(), ValueWireDecodeError>

Validates a named collection and reuses collection budget accounting.

Parameters

• value - Named collection to validate.

Errors

Returns a resource-limit error for the wrapper name or nested values.

pub fn check_named_multi_values_at( &mut self, value: &NamedMultiValues, depth: usize, ) -> Result<(), ValueWireDecodeError>

Validates a named collection at an embedding depth.

Parameters

• value - Named collection to validate.
• depth - Root-inclusive depth of the named wrapper.

Errors

Returns a resource-limit error for the wrapper name or nested values.

pub fn check_value_at( &mut self, value: &Value, depth: usize, ) -> Result<(), ValueWireDecodeError>

Validates one scalar value at an embedding depth.

Use this method when the scalar is nested inside an outer wire document. The depth is inclusive and should be supplied by the outer protocol’s accounting traversal.

Parameters

• value - Scalar value to validate.
• depth - Root-inclusive depth of the scalar in the complete document.

Errors

Returns a resource-limit error when the value exceeds the configured depth, node, string, or numeric budget.

Trait Implementations

impl Debug for WireBudget

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

Formats the value using the given formatter.