use struct_string_template::TemplaterBuilder;

let templater = TemplaterBuilder::<Book>::new()
    .with_selector("id", |book| Some(book.id.to_string()))
    .with_selector("title", |book| Some(book.title.clone()))
    .with_selector("所有作者", |book| {
        Some(format!("(By: {}{})",
            &book.author,
            &book.contributors.clone().map(|x| format!(", {}", x)).or(Some("".to_owned())).unwrap())
        )
    })
    .build();

使用 Templater 的 render 函数进行渲染

let result = templater.render(&my_book, format_string).ok().unwrap();
println!("{}", &result);

高级用法

不使用 TemplateBuilder 构建 Templater

如果需要迭代地构建 Templater 而不是使用构建器类，则使用 Templater::new()，然后使用 insert 或 extend 方法添加闭包。

let mut templater = Templater::<Book>::new();
templater.insert("id", |book| Some(book.id.to_string()));
templater.insert("title", |book| Some(book.title.clone()));
templater.insert("所有作者", |book| {
    Some(format!("(By: {}{})",
        &book.author,
        &book.contributors.clone().map(|x| format!(", {}", x)).or(Some("".to_owned())).unwrap())
    )
});

格式化器

如果您打算多次使用格式化字符串，可以使用类似于正则表达式的“预编译”它，以使用 Formatter 类（render 将格式化字符串内部转换为 Formatter）来提高性能，然后传递 Formatter 变量到 renderf 函数

use struct_string_template::Formatter;

let formatter = Formatter::build(format_string).ok().unwrap();
let result = templater.renderf(&my_book, &formatter);
println!("{}", &result);

错误处理

有关抛出的错误，请参阅 src/err.rs

模板规则

在本节中，X 是任何 选择器

1. %% 被视为一个字面量 %
2. % 后跟一个不是 ( 的字符（或字符串的结尾）是无效的
3. %(X) 总是有效的
4. %(X)A 其中 A 是任何有效的字符串是有效的
5. %(X（模板未终止）是无效的
6. 没有与 X 关联的闭包是无效的
7. 如果结构上闭包的返回值为 None，则打印 NA。这目前无法配置，除非修改闭包本身。