Struct tera::Context[][src]

pub struct Context { /* fields omitted */ }

The struct that holds the context of a template rendering.

Light wrapper around a BTreeMap for easier insertions of Serializable values


impl Context[src]

pub fn new() -> Self[src]

Initializes an empty context

pub fn insert<T: Serialize + ?Sized, S: Into<String>>(
    &mut self,
    key: S,
    val: &T

Converts the val parameter to Value and insert it into the context.

Panics if the serialization fails.

let mut context = tera::Context::new();
context.insert("number_users", &42);

pub fn try_insert<T: Serialize + ?Sized, S: Into<String>>(
    &mut self,
    key: S,
    val: &T
) -> TeraResult<()>

Converts the val parameter to Value and insert it into the context.

Returns an error if the serialization fails.

let mut context = Context::new();
// user is an instance of a struct implementing `Serialize`
if let Err(_) = context.try_insert("number_users", &user) {
    // Serialization failed

pub fn extend(&mut self, source: Context)[src]

Appends the data of the source parameter to self, overwriting existing keys. The source context will be dropped.

let mut target = Context::new();
target.insert("a", &1);
target.insert("b", &2);
let mut source = Context::new();
source.insert("b", &3);
source.insert("d", &4);

pub fn into_json(self) -> Value[src]

Converts the context to a serde_json::Value consuming the context.

pub fn from_value(obj: Value) -> TeraResult<Self>[src]

Takes a serde-json Value and convert it into a Context with no overhead/cloning.

pub fn from_serialize(value: impl Serialize) -> TeraResult<Self>[src]

Takes something that impl Serialize and create a context with it. Meant to be used if you have a hashmap or a struct and don’t want to insert values one by one in the context.

pub fn get(&self, index: &str) -> Option<&Value>[src]

Returns the value at a given key index.

pub fn contains_key(&self, index: &str) -> bool[src]

Checks if a value exists at a specific index.

Trait Implementations

impl Clone for Context[src]

impl Debug for Context[src]

impl Default for Context[src]

impl PartialEq<Context> for Context[src]

impl StructuralPartialEq for Context[src]

Auto Trait Implementations

impl RefUnwindSafe for Context

impl Send for Context

impl Sync for Context

impl Unpin for Context

impl UnwindSafe for Context

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized

impl<T> Borrow<T> for T where
    T: ?Sized

impl<T> BorrowMut<T> for T where
    T: ?Sized

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 

impl<T> ToOwned for T where
    T: Clone

type Owned = T

The resulting type after obtaining ownership.

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<V, T> VZip<V> for T where
    V: MultiLane<T>,