Форматований друк

Друк обробляється серією макросів, визначених у std::fmt, деякі з яких:

• format!: записує форматований текст у String
• print!: те саме, що й format!, але текст друкується в консоль (io::stdout).
• println!: те саме, що й print!, але додається новий рядок.
• eprint!: те саме, що й print!, але текст друкується у стандартний потік помилок (io::stderr).
• eprintln!: те саме, що й eprint!, але додається новий рядок.

Усі вони розбирають текст однаковим способом. Крім того, Rust перевіряє коректність форматування під час компіляції.

fn main() {
    // In general, the `{}` will be automatically replaced with any
    // arguments. These will be stringified.
    println!("{} days", 31);

    // Positional arguments can be used. Specifying an integer inside `{}`
    // determines which additional argument will be replaced. Arguments start
    // at 0 immediately after the format string.
    println!("{0}, this is {1}. {1}, this is {0}", "Alice", "Bob");

    // As can named arguments.
    println!("{subject} {verb} {object}",
             object="the lazy dog",
             subject="the quick brown fox",
             verb="jumps over");

    // Different formatting can be invoked by specifying the format character
    // after a `:`.
    println!("Base 10:               {}",   69420); // 69420
    println!("Base 2 (binary):       {:b}", 69420); // 10000111100101100
    println!("Base 8 (octal):        {:o}", 69420); // 207454
    println!("Base 16 (hexadecimal): {:x}", 69420); // 10f2c

    // You can right-justify text with a specified width. This will
    // output "    1". (Four white spaces and a "1", for a total width of 5.)
    println!("{number:>5}", number=1);

    // You can pad numbers with extra zeroes,
    println!("{number:0>5}", number=1); // 00001
    // and left-adjust by flipping the sign. This will output "10000".
    println!("{number:0<5}", number=1); // 10000

    // You can use named arguments in the format specifier by appending a `$`.
    println!("{number:0>width$}", number=1, width=5);

    // Rust even checks to make sure the correct number of arguments are used.
    println!("My name is {0}, {1} {0}", "Bond");
    // FIXME ^ Add the missing argument: "James"

    // Only types that implement fmt::Display can be formatted with `{}`. User-
    // defined types do not implement fmt::Display by default.

    #[allow(dead_code)] // disable `dead_code` which warn against unused module
    struct Structure(i32);

    // This will not compile because `Structure` does not implement
    // fmt::Display.
    // println!("This struct `{}` won't print...", Structure(3));
    // TODO ^ Try uncommenting this line

    // For Rust 1.58 and above, you can directly capture the argument from a
    // surrounding variable. Just like the above, this will output
    // "    1", 4 white spaces and a "1".
    let number: f64 = 1.0;
    let width: usize = 5;
    println!("{number:>width$}");
}

std::fmt містить багато traits, які визначають відображення тексту. Базова форма двох важливих із них наведена нижче:

• fmt::Debug: використовує позначку {:?}. Форматує текст для цілей налагодження.
• fmt::Display: використовує позначку {}. Форматує текст у більш елегантний, зручний для користувача спосіб.

Тут ми використали fmt::Display, тому що бібліотека std надає реалізації для цих типів. Щоб друкувати текст для власних типів, потрібні додаткові кроки.

Реалізація трейт-об’єкта fmt::Display автоматично реалізує ToString трейт, який дозволяє [перетворити] тип на String.

У рядку 43 #[allow(dead_code)] — це [атрибут], який застосовується лише до елемента після нього.

Дії

• Виправте проблему у наведеному вище коді (див. FIXME), щоб він запускався без помилки.
• Спробуйте розкоментувати рядок, який намагається форматувати структуру Structure (див. TODO)
• Додайте виклик макроса println!, який виводить: Pi is roughly 3.142, контролюючи кількість показаних десяткових знаків. Для цього вправи використайте let pi = 3.141592 як оцінку pi. (Підказка: можливо, вам потрібно буде перевірити документацію std::fmt щодо встановлення кількості десяткових знаків для відображення)

Див. також:

std::fmt, macros, struct, traits, і dead_code