Arguments, positions, and captured variables

A Rust replacement field can select a value four ways: use the next implicit argument, select a positional argument by index, use an explicit named argument, or capture an identifier that is already in scope. Formatting after the colon follows the same rules regardless of how the value was selected.

EXAMPLE: CI-CHECKEDTEST ASSERTED · examples/format-output/src/format_pages.rs#page-arguments-capture

let language = "Rust";
assert_eq!(
    format!("{language}: {1} before {0}", "first", "second"),
    "Rust: second before first"
);

Implicit arguments

The shortest form is {}. Rust consumes the next unused implicit argument. This is usually the clearest form when values appear once and in order.

Explicit positions

An integer inside the braces selects a positional argument directly. {1} {0} can reverse two arguments without changing the argument list.

Explicit positions are useful when one argument is reused or when the output order differs from the call-site order. In longer format strings, avoid mixing styles so heavily that the argument flow becomes difficult to audit.

Named arguments and capture

You can pass an explicit named argument, or capture a local variable directly by name. Capture is concise when the local variable already has a meaningful name; explicit naming is useful when the label in the format string should differ from the local identifier.

Selection ends at the colon

In {value:>8.2}, value selects the argument. Everything after : controls its representation: alignment, width, precision, flags, and formatting trait.

Width and precision can also be supplied from formatting arguments. The main Rust format strings reference shows the basic dynamic-width form, while precision explains what the precision value means for different output types.