Rust format_args用法及代碼示例

用法

macro_rules! format_args {
    ($fmt : expr) => { ... };
    ($fmt : expr, $($args : tt) *) => { ... };
}

為其他字符串格式化宏構造參數。

該宏通過為每個傳遞的附加參數獲取包含{} 的格式化字符串文字來發揮作用。 format_args! 準備附加參數以確保輸出可以解釋為字符串並將參數規範化為單一類型。任何實現 Display 特征的值都可以傳遞給 format_args! ，任何 Debug 實現都可以傳遞給格式化字符串中的 {:?} 。

這個宏產生一個類型為 fmt::Arguments 的值。該值可以傳遞給 std::fmt 中的宏以執行有用的重定向。所有其他格式化宏( format! ， write! ， println! ，等等)都通過這個代理。 format_args! 與其派生的宏不同，它避免了堆分配。

您可以在 Debug 和 Display 上下文中使用 format_args! 返回的 fmt::Arguments 值，如下所示。該示例還顯示 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);

有關詳細信息，請參閱 std::fmt 中的文檔。

例子

use std::fmt;

let s = fmt::format(format_args!("hello {}", "world"));
assert_eq!(s, format!("hello {}", "world"));