Struct ProcessingStack 

pub struct ProcessingStack<I> { /* private fields */ }

The chain of remote context URLs currently being processed.

This is the specification’s remote contexts array. It serves two purposes: spotting a context that includes itself, and bounding the length of a remote context chain at MAX_REMOTE_CONTEXTS. Whether it is empty also tells the algorithm whether the context being processed came from a remote document, which is what decides if its @base entry applies.

Implemented as an immutable singly-linked list behind Arcs, so the copy each recursive call receives is a pointer bump rather than a clone of the chain.

Implementations

impl<I> ProcessingStack<I>

pub fn new() -> Self

Creates an empty stack, meaning no remote context is being processed.

pub fn is_empty(&self) -> bool

Checks whether no remote context has been entered, i.e. the context being processed is not itself remote.

pub fn len(&self) -> usize

Returns the number of remote contexts on the stack.

Walks the chain, so this is linear in the stack depth.

pub fn cycle(&self, url: &I) -> bool

where I: PartialEq,

Checks whether url is already on the stack, meaning entering it would close a loop.

pub fn push(&mut self, url: I) -> bool

where I: PartialEq,

Pushes url onto the stack, unless it is already there.

Returns true when the URL was added, and false when it was already on the stack and nothing changed. What false means is version-dependent: JSON-LD 1.0 treats it as a recursive context inclusion error, while 1.1 simply skips reprocessing the context.

Trait Implementations

impl<I: Clone> Clone for ProcessingStack<I>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<I> Default for ProcessingStack<I>

fn default() -> Self

Returns the “default value” for a type.