use std::collections::HashMap;
use human_string_filler::StrExt;

let mut map = HashMap::new();
map.insert("name", "world");

let s = "Hello, {name}!".fill_to_string(&map);

assert_eq!(s.unwrap(), "Hello, world!");

或者如果你喜欢，可以为你自己的某些类型实现 Filler 特性。

Cargo 功能

• std（默认启用）：用于 #![no_std] 操作。隐含 alloc。

  • 为 std::error::Error 实现 Error；
  • 为 &HashMap 实现 Filler。

• alloc（通过 std 默认启用）

  • 为 &BTreeMap 实现 Filler。
  • fill_to_string 和 StrExt::fill_to_string。

模板语言

这是模板语言在 ABNF 中的语法。

unescaped-normal-char = %x00-7A / %x7C / %x7E-D7FF / %xE000-10FFFF
                      ; any Unicode scalar value except for "{" and "}"

normal-char           = unescaped-normal-char / "{{" / "}}"

template-region       = "{" *unescaped-normal-char "}"

template-string       = *( normal-char / template-region )

这个正则表达式将验证一个模板字符串。

^([^{}]|\{\{|\}\}|\{[^{}]*\})*$

样本合法模板字符串

• 空字符串
• Hello, {name}!：一个带有键 "name" 的模板区域。
• 今天是 {date:short}：一个带有“date:short”键的模板区域。尽管没有像format!()宏那样的格式指定，但冒号约定是一种合理的选项——参见下一节。
• Hello, {}!：一个带有空键的模板区域，不建议但允许。
• Escaped {{花括号 {和替换} for {fun}!：字符串 "Escaped { 花括号 "，后面跟着一个带有键 "and replacements" 的模板区域，然后是字符串 " for "，然后是带有键 "fun" 的模板区域，最后是字符串 "!"。

示例非法模板字符串

• hello, {world}foo}：括号必须匹配；其他任何字符（特别是字符串的最后一个字符）必须通过重复来转义。
• {{thing}：`{` 是转义的开括号，所以 `}` 是不匹配的。
• {thi{{n}}g}：模板区域键中不能有任何形式的括号。（未来版本可能会使转义模板区域内的括号成为可能，如果它在像格式说明符这样的东西中证明是有用的；但不是现在。）

键语义约定

键是一个任意字符串（除了它不能包含 `{ 或 `}`），没有显式定义的语义，但这里有一些建议，包括辅助函数。

1. 如果有格式指定符（例如，指定要使用的日期格式或是否用前导零填充数字，等等）是有意义的，则在像 `:` 这样的字符上进行一次分割。为此，提供了一个名为 `split_on 的函数。

2. 对于更高级的格式化，其中您希望设置多个属性，`split_propertied 为诸如 `{key prop1 prop2=val2}` 和 `{key:prop1,prop2=val2}` 这样的字符串提供了一些合理且简单的语义。

3. 如果嵌套属性访问是有意义的，则使用 `. 进行分割，使用 `key.split('.')` 迭代器。如果您正在使用上面提到的 `split_on 或 `split_propertied，您可能希望首先应用它们来分离键部分。

4. 仅使用UAX #31标识符作为键（或键，如果支持嵌套属性访问）。大多数时候，空字符串和数字可能不是一个好主意。