Formateo

Hemos visto que este formato se especifica via una cadena de formato:

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

La misma variable (foo) puede formatearse de manera diferente dependiendo de cuál sea tipo de argumento utilizado: X vs o vs no especificado.

Esta funcionalidad de formato se implementa a través de traits, y hay trait para cada tipo de argumento. El trait de formato más común es la Display, que maneja casos en los que el tipo de argumento se deja sin especificar: {}, por ejemplo.

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

struct City {
    name: &'static str,
    // Latitude
    lat: f32,
    // Longitude
    lon: f32,
}

impl Display for City {
    // `f` es un búfer, y este método se usa para formatear y meterle una cadena.
    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!` es como `format!`, pero escribirá la cadena formateada
        // al búfer (el primer argumento).
        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 },
    ] {
        // Cambia esto a {} una vez que hayas añadido una implementación
        // para fmt::Display.
        println!("{:?}", color);
    }
}

Puede ver una lista completa de traits de formato y sus tipos de argumentos en la documentación de std::fmt.

Actividad

Agrega una implementación del trait fmt::Display para la estructura Colorarriba para que la salida se muestre como:

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

Two hints if you get stuck:

• Puede que necesites enumerar cada color más de una vez.
• You can pad with zeros to a width of 2 with :0>2. For hexadecimals, you can use :02X.

Bonus:

• If you would like to experiment with type casting in advance, the formula for calculating a color in the RGB color space is RGB = (R * 65_536) + (G * 256) + B, where R is RED, G is GREEN, and B is BLUE. An unsigned 8-bit integer (u8) can only hold numbers up to 255. To cast u8 to u32, you can write variable_name as u32.

Ver también

std::fmt