Struct formatx::Template

pub struct Template { /* private fields */ }

String templating with std::fmt syntax.

Example

use formatx::Template;

let mut template = "{percentage:.2}".parse::<Template>().unwrap();
template.replace("percentage", 67.7892);
assert_eq!(template.text().unwrap(), "67.79");

Implementations

impl Template

pub fn new<T: Into<String>>(template: T) -> Result<Self, Error>

Create a new instance of format_template::Template.

Example

use formatx::Template;

let template = Template::new("{percentage:.2}").unwrap();

pub fn contains<T: ToString>(&self, placeholder: T) -> bool

Checks wheter template contains placeholder or not.

pub fn unchecked_text(&self) -> String

Returns unchecked formatted template. For Result version of fomatted template use .text method.

pub fn text(&self) -> Result<String, Error>

Checks wheter all placeholders are replaced or not and returns formatted template.

pub fn replace<T, U>(&mut self, placeholder: T, value: U) where
    T: ToString,
    U: Display + Debug, 

Replace a template placeholder with a value. This change is inplace.

pub fn replace_positional<T>(&mut self, value: T) where
    T: Display + Debug, 

Replace a template positional placeholder with a value. This change is inplace.

pub fn replace_from_callback<T, U>(&mut self, placeholder: T, callback: U) where
    T: ToString,
    U: Fn(&Placeholder) -> String, 

Replace a template placeholder from a callback String. This change is inplace.

pub fn replace_with_callback<T, U, V>(
    &mut self,
    placeholder: T,
    value: U,
    callback: V
) where
    T: ToString,
    U: Display + Debug,
    V: Fn(String, &Placeholder) -> String, 

Replace a template placeholder with a value and do additional formatting using callback. This change is inplace.

Trait Implementations

impl Clone for Template

fn clone(&self) -> Template

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Template

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

Formats the value using the given formatter.

impl Display for Template

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

Formats the value using the given formatter.

impl FromStr for Template

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.