Struct Template 

pub struct Template<'a>(/* private fields */);

A lazily evaluated text template with named holes for interpolating properties into.

The Template::render method can be used to format a template with Props into a string or other representation.

Template equality is based on the equality of their renderings.

Two templates can be equal if they’d render to the same outputs. That means they must have the same holes in the same positions, but their text tokens may be split differently, so long as they produce the same text.

Implementations

impl Template<'static>

pub const fn new(parts: &'static [Part<'static>]) -> Template<'static>

Create a template from a set of tokens.

pub const fn literal(text: &'static str) -> Template<'static>

Create a template from a string literal with no holes.

impl<'a> Template<'a>

pub const fn new_ref(parts: &'a [Part<'a>]) -> Template<'a>

Create a template from a borrowed set of tokens.

The Template::new method should be preferred where possible.

pub const fn literal_ref(text: &'a str) -> Template<'a>

Create a template from a string literal with no holes.

The Template::literal method should be preferred where possible.

pub fn by_ref<'b>(&'b self) -> Template<'b>

Get a new template, borrowing data from this one.

pub fn as_literal(&self) -> Option<&Str<'a>>

Try get the value of the template as a string literal.

If the template only has a single token, and that token is text, then this method will return Some. Otherwise this method will return None.

pub fn parts(&self) -> Parts<'_, 'a>

Iterate over the parts of the template.

pub fn render<'b, P>(&'b self, props: P) -> Render<'b, P>

Lazily render the template, using the given properties for interpolation.

impl Template<'static>

pub fn new_owned(parts: impl Into<Box<[Part<'static>]>>) -> Template<'static>

Create a template from a set of owned parts.

impl<'a> Template<'a>

pub fn to_owned(&self) -> Template<'static>

Get a new template from this one, converting its parts into owned data.

If the template already contains owned data then this method will simply clone it.

Trait Implementations

impl<'a> Clone for Template<'a>

fn clone(&self) -> Template<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Template<'a>

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

Formats the value using the given formatter.

impl<'a> Display for Template<'a>

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

Formats the value using the given formatter.

impl<'a> From<&'a [Part<'a>]> for Template<'a>

fn from(value: &'a [Part<'a>]) -> Template<'a>

Converts to this type from the input type.

impl<'a, 'b> PartialEq<Template<'b>> for Template<'a>

fn eq(&self, other: &Template<'b>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'k> Serialize for Template<'k>

Available on crate feature serde only.

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<'a> ToValue for Template<'a>

fn to_value(&self) -> Value<'_>

Perform the conversion.

impl<'k> Value for Template<'k>

Available on crate feature sval only.

fn stream<'sval, S>(&'sval self, stream: &mut S) -> Result<(), Error>

where S: Stream<'sval> + ?Sized,

Stream this value through a Stream.

fn tag(&self) -> Option<Tag>

Get the tag of this value, if there is one.

fn to_bool(&self) -> Option<bool>

Try convert this value into a boolean.

fn to_f32(&self) -> Option<f32>

Try convert this value into a 32bit binary floating point number.

fn to_f64(&self) -> Option<f64>

Try convert this value into a 64bit binary floating point number.

fn to_i8(&self) -> Option<i8>

Try convert this value into a signed 8bit integer.

fn to_i16(&self) -> Option<i16>

Try convert this value into a signed 16bit integer.

fn to_i32(&self) -> Option<i32>

Try convert this value into a signed 32bit integer.

fn to_i64(&self) -> Option<i64>

Try convert this value into a signed 64bit integer.

fn to_i128(&self) -> Option<i128>

Try convert this value into a signed 128bit integer.

fn to_u8(&self) -> Option<u8>

Try convert this value into an unsigned 8bit integer.

fn to_u16(&self) -> Option<u16>

Try convert this value into an unsigned 16bit integer.

fn to_u32(&self) -> Option<u32>

Try convert this value into an unsigned 32bit integer.

fn to_u64(&self) -> Option<u64>

Try convert this value into an unsigned 64bit integer.

fn to_u128(&self) -> Option<u128>

Try convert this value into an unsigned 128bit integer.

fn to_text(&self) -> Option<&str>

Try convert this value into a text string.

fn to_binary(&self) -> Option<&[u8]>

Try convert this value into a bitstring.

impl<'k> ValueRef<'k> for Template<'k>

Available on crate feature sval only.

fn stream_ref<S>(&self, stream: &mut S) -> Result<(), Error>

where S: Stream<'k> + ?Sized,

Stream this value through a Stream.

impl<'a> Eq for Template<'a>