Macro alloc::format

1.0.0 · source ·
macro_rules! format {
    ($($arg:tt)*) => { ... };
}
Expand description

使用运行时表达式的插值创建 String

format! 收到的第一个参数是格式字符串。这必须是字符串字面量。格式字符串的作用是包含在 {{} 中。

除非使用命名或位置参数,否则传递给 format! 的其他参数将以给定的顺序替换格式字符串中的 {}。有关更多信息,请参见 std::fmt

format! 的常见用法是字符串的连接和内插。 print!write! 宏使用相同的约定,具体取决于字符串的预期目标。

要将单个值转换为字符串,请使用 to_string 方法。这将使用 Display 格式 trait。

Panics

如果格式化 trait 实现返回了错误,则会出现 format! panics。 这表明实现不正确,因为 fmt::Write for String 本身从不返回错误。

Examples

format!("test");
format!("hello {}", "world!");
format!("x = {}, y = {y}", 10, y = 30);
let (x, y) = (1, 2);
format!("{x} + {y} = 3");
Run