フォーマット

フォーマットは_フォーマット文字列_によって指定されることを見てきました。

• format!("{}", foo) -> "3735928559"
• format!("0x{:X}", foo) -> "0xDEADBEEF"
• format!("0o{:o}", foo) -> "0o33653337357"

同じ変数（foo）でも、使用する_引数型_によって異なる形式でフォーマットできます: X vs o vs 未指定。

このフォーマット機能はトレイトによって実装されており、各引数型に対して1つのトレイトがあります。最も一般的なフォーマット用トレイトは Display で、引数型が未指定のままの場合を扱います。たとえば {} です。

use std::fmt::{self, Formatter, Display};

struct City {
    name: &'static str,
    // 緯度
    lat: f32,
    // 経度
    lon: f32,
}

impl Display for City {
    // `f` はバッファーであり、このメソッドはフォーマット済みの文字列をそこに書き込まなければなりません。
    fn fmt(&self, f: &mut Formatter) -> fmt::Result {
        let lat_c = if self.lat >= 0.0 { 'N' } else { 'S' };
        let lon_c = if self.lon >= 0.0 { 'E' } else { 'W' };

        // `write!` は `format!` に似ていますが、フォーマット済みの文字列を
        // バッファー（最初の引数）に書き込みます。
        write!(f, "{}: {:.3}°{} {:.3}°{}",
               self.name, self.lat.abs(), lat_c, self.lon.abs(), lon_c)
    }
}

#[derive(Debug)]
struct Color {
    red: u8,
    green: u8,
    blue: u8,
}

fn main() {
    for city in [
        City { name: "Dublin", lat: 53.347778, lon: -6.259722 },
        City { name: "Oslo", lat: 59.95, lon: 10.75 },
        City { name: "Vancouver", lat: 49.25, lon: -123.1 },
    ] {
        println!("{}", city);
    }
    for color in [
        Color { red: 128, green: 255, blue: 90 },
        Color { red: 0, green: 3, blue: 254 },
        Color { red: 0, green: 0, blue: 0 },
    ] {
        // fmt::Display の実装を追加したら、これを {} を使うように
        // 切り替えてください。
        println!("{:?}", color);
    }
}

std::fmt のドキュメントで、フォーマット用トレイトの完全な一覧とその引数型を確認できます。

演習

上記の Color 構造体に fmt::Display トレイトの実装を追加し、出力が次のように表示されるようにしてください。

RGB (128, 255, 90) 0x80FF5A
RGB (0, 3, 254) 0x0003FE
RGB (0, 0, 0) 0x000000

行き詰まった場合のヒントを2つ示します。

• 各色を複数回列挙する必要があるかもしれません。
• :0>2 を使うと、幅 2 になるようにゼロでパディングできます。 16進数には :02X を使えます。

ボーナス:

• 事前に型キャストを試してみたい場合、RGB色空間で色を計算するための式は RGB = (R * 65_536) + (G * 256) + B です。ここで R is RED, G is GREEN, and B is BLUE です。 符号なし8ビット整数（u8）は 255 までの数値しか保持できません。u8 を u32 にキャストするには、variable_name as u32 と書けます。

関連項目:

std::fmt