Struct minijinja::State

pub struct State<'vm, 'env> { /* private fields */ }

Provides access to the current execution state of the engine.

A read only reference is passed to filter functions and similar objects to allow limited interfacing with the engine. The state is useful to look up information about the engine in filter, test or global functions. It not only provides access to the template environment but also the context variables of the engine, the current auto escaping behavior as well as the auto escape flag.

Notes on lifetimes: the state object exposes some of the internal lifetimes through the type. You should always elide these lifetimes as there might be lifetimes added or removed between releases.

Implementations

impl<'vm, 'env> State<'vm, 'env>

pub fn env(&self) -> &Environment<'_>

Returns a reference to the current environment.

pub fn name(&self) -> &str

Returns the name of the current template.

pub fn auto_escape(&self) -> AutoEscape

Returns the current value of the auto escape flag.

pub fn undefined_behavior(&self) -> UndefinedBehavior

Returns the current undefined behavior.

pub fn current_block(&self) -> Option<&str>

Returns the name of the innermost block.

pub fn current_call(&self) -> Option<&str>

Returns the name of the item (filter, function, test, method) currently being called.

pub fn lookup(&self, name: &str) -> Option<Value>

Looks up a variable by name in the context.

Trait Implementations

impl<'a> ArgType<'a> for &State<'_, '_>

type Output = &'a State<'a, 'a>

The output type of this argument.

impl<'vm, 'env> Debug for State<'vm, 'env>

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

Formats the value using the given formatter.