Struct std::fmt::Arguments

pub struct Arguments<'a> { /* fields omitted */ }

该结构体表示格式字符串及其参数的安全预编译版本。 由于无法安全地完成此操作，因此无法在运行时生成该文件，因此未提供任何构造函数，并且该字段为私有字段以防止修改。

format_args! 宏将安全地创建此结构体的实例。 宏在编译时验证格式字符串，因此可以安全地执行 write() 和 format() 函数的使用。

您可以在 Debug 和 Display 上下文中使用 format_args! 返回的 Arguments<'a>，如下所示。 该示例还显示 Debug 和 Display 的格式相同: format_args! 中的插值格式字符串。

let debug = format!("{:?}", format_args!("{} foo {:?}", 1, 2));
let display = format!("{}", format_args!("{} foo {:?}", 1, 2));
assert_eq!("1 foo 2", display);
assert_eq!(display, debug);

Implementations

impl<'a> Arguments<'a>

pub const fn as_str(&self) -> Option<&'static str>

获取格式化的字符串 (如果没有要格式化的参数)。

在最琐碎的情况下，这可以用来避免分配。

Examples

use std::fmt::Arguments;

fn write_str(_: &str) { /* ... */ }

fn write_fmt(args: &Arguments) {
    if let Some(s) = args.as_str() {
        write_str(s)
    } else {
        write_str(&args.to_string());
    }
}

assert_eq!(format_args!("hello").as_str(), Some("hello"));
assert_eq!(format_args!("").as_str(), Some(""));
assert_eq!(format_args!("{}", 1).as_str(), None);

Trait Implementations

impl<'a> Clone for Arguments<'a>

pub fn clone(&self) -> Arguments<'a>

返回值的副本。

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

从 source 执行复制分配。

impl<'_> Debug for Arguments<'_>

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

使用给定的格式化程序格式化该值。

impl<'_> Display for Arguments<'_>

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

使用给定的格式化程序格式化该值。

impl<'a> Copy for Arguments<'a>