Struct Limits 

pub struct Limits { /* private fields */ }

Limits the size of the deserialized data (a value of the Context).

Deser does not use the stack to process nested data, so deeply nested input cannot overflow the stack during deserialization. Still it can be useful to limit the size of untrusted input, as the values that are deserialized might be processed recursively later, or to limit the memory used. All limits are off by default.

The limits are configured in the context, for instance in the configuration of a format:

use deser::de::Limits;
use deser::Context;

let config = deser_json::DeserializerConfig::builder()
    .context(Context::with(Limits::builder().max_depth(1).build()))
    .build();
let err = config.from_str::<Vec<Vec<u32>>>("[[1]]").unwrap_err();
assert_eq!(
    err.to_string(),
    "LimitExceeded: recursion limit exceeded at line 1 column 2"
);

The DeserializeDriver enforces the limits of its context (see set_context). They see the events as the sinks receive them, after all Layers, so their errors have the context that layers add (for instance the path).

Implementations

impl Limits

pub const fn new() -> Limits

Creates limits that limit nothing.

pub const fn builder() -> LimitsBuilder

Returns a builder for the limits (see LimitsBuilder).

pub const fn into_builder(self) -> LimitsBuilder

Returns a builder that starts with these limits.

pub const fn set_max_depth(&mut self, depth: usize)

Limits the nesting depth of maps and sequences.

With a depth of 1, maps and sequences cannot contain other maps and sequences.

pub const fn max_depth(&self) -> Option<usize>

Returns the limit of the nesting depth of maps and sequences.

pub const fn set_max_events(&mut self, events: usize)

Limits the total number of events.

Every atom and every start and end of a map or sequence counts.

pub const fn max_events(&self) -> Option<usize>

Returns the limit of the total number of events.

pub const fn set_max_items(&mut self, items: usize)

Limits the number of items in a sequence and entries in a map.

pub const fn max_items(&self) -> Option<usize>

Returns the limit of the number of items in a sequence and entries in a map.

pub const fn set_max_len(&mut self, len: usize)

Limits the length of strings and bytes (in bytes).

pub const fn max_len(&self) -> Option<usize>

Returns the limit of the length of strings and bytes (in bytes).

Trait Implementations

impl Clone for Limits

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Limits

impl Debug for Limits

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

Formats the value using the given formatter.

impl Default for Limits

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Limits

impl PartialEq for Limits

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Limits