Rust write用法及代码示例

本文简要介绍rust语言中 Macro std::write 的用法。

用法

macro_rules! write {
    ($dst : expr, $($arg : tt) *) => { ... };
}

将格式化数据写入缓冲区。

此宏接受'writer'、格式字符串和参数列表。参数将根据指定的格式字符串进行格式化，并将结果传递给编写器。 writer 可以是任何带有write_fmt 方法的值；通常这来自 fmt::Write 或 io::Write 特征的实现。宏返回 write_fmt 方法返回的任何内容；通常是 fmt::Result 或 io::Result 。

有关格式字符串语法的更多信息，请参阅 std::fmt 。

例子

use std::io::Write;

fn main() -> std::io::Result<()> {
    let mut w = Vec::new();
    write!(&mut w, "test")?;
    write!(&mut w, "formatted {}", "arguments")?;

    assert_eq!(w, b"testformatted arguments");
    Ok(())
}

模块可以同时导入 std::fmt::Write 和 std::io::Write 并在实现其中任何一个的对象上调用 write!，因为对象通常不会同时实现这两者。但是，模块必须导入限定的特征，以便它们的名称不会冲突：

use std::fmt::Write as FmtWrite;
use std::io::Write as IoWrite;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut s = String::new();
    let mut v = Vec::new();

    write!(&mut s, "{} {}", "abc", 123)?; // uses fmt::Write::write_fmt
    write!(&mut v, "s = {:?}", s)?; // uses io::Write::write_fmt
    assert_eq!(v, b"s = \"abc 123\"");
    Ok(())
}

注意：该宏也可以在no_std 设置中使用。在no_std 设置中，您负责组件的实现细节。

use core::fmt::Write;

struct Example;

impl Write for Example {
    fn write_str(&mut self, _s: &str) -> core::fmt::Result {
         unimplemented!();
    }
}

let mut m = Example{};
write!(&mut m, "Hello World").expect("Not written");

相关用法

注：本文由纯净天空筛选整理自rust-lang.org大神的英文原创作品 Macro std::write。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。