Struct Limits 

pub struct Limits {
    pub max_depth: u32,
    pub max_elements: u64,
    pub max_element_length: u64,
    pub max_work: u64,
}

How much a parse may spend.

The defaults are generous, because they exist to stop a document that is trying to make this run forever, not to decide that real documents are too big. A caller on a device with less to spend lowers them.

Fields

max_depth: u32

How deeply elements may nest.

Certificates and signed data nest perhaps a dozen deep. A thousand is a document doing something else.

max_elements: u64

How many elements may be read in total.

max_element_length: u64

How long a single element’s contents may be.

max_work: u64

How many bytes of header and structure may be examined.

Content bytes are not counted against this: reading a large certificate is not the thing worth stopping. What this bounds is the number of elements-worth of parsing a document can ask for, which is what a deeply or densely nested input inflates.

Implementations

impl Limits

pub fn none() -> Self

Limits that allow nothing beyond a single shallow element, for tests and for callers that want to prove a budget is enforced.

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