Struct Position 

pub(super) struct Position {
    input_len: Length,
    position: Length,
    depth: usize,
}

State tracker for the current position in the input.

Fields

input_len: Length

Input length (in bytes after Base64 decoding).

position: Length

Position in the input buffer (in bytes after Base64 decoding).

depth: usize

Number of nested productions encountered (i.e. depth in the call stack).

Implementations

impl Position

const MAX_DEPTH: usize = 64

Maximum number of nested messages we tolerate (prevents stack exhaustion).

pub(super) fn new(input_len: Length) -> Self

Create a new position tracker with the given overall length.

pub(super) fn advance(&mut self, amount: Length) -> Result<Length>

Advance the current position by the given amount.

Returns the new current position.

pub(super) fn current(&self) -> Length

Get the current position.

pub(super) fn error(&mut self, kind: ErrorKind) -> Error

Create new Error from the given ErrorKind which includes the current position.

pub(super) fn input_len(&self) -> Length

Get the input length.

pub(super) fn remaining_len(&self) -> Length

Get the remaining length.

pub(super) fn split_nested(&mut self, len: Length) -> Result<Resumption>

Split a nested position tracker of the given size.

Returns

A Resumption value which can be used to continue parsing the outer message.

pub(super) fn resume_nested(&mut self, resumption: Resumption)

Resume processing the rest of a message after processing a nested inner portion.

Trait Implementations

impl Clone for Position

fn clone(&self) -> Position

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Position

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

Formats the value using the given formatter.