新类型惯用法

newtype 惯用法提供了编译时保证，确保向程序提供了正确类型的值。

例如，一个检查以年为单位的年龄的年龄验证函数，必须给定一个类型为 Years 的值。

struct Years(i64);

struct Days(i64);

impl Years {
    pub fn to_days(&self) -> Days {
        Days(self.0 * 365)
    }
}

impl Days {
    /// truncates partial years
    pub fn to_years(&self) -> Years {
        Years(self.0 / 365)
    }
}

fn is_adult(age: &Years) -> bool {
    age.0 >= 18
}

fn main() {
    let age = Years(25);
    let age_days = age.to_days();
    println!("Is an adult? {}", is_adult(&age));
    println!("Is an adult? {}", is_adult(&age_days.to_years()));
    // println!("Is an adult? {}", is_adult(&age_days));
}

取消注释最后一个打印语句，以观察到提供的类型必须是 Years。

要获取 newtype 的值作为其基础类型，你可以使用元组或解构语法，如下所示：

struct Years(i64);

fn main() {
    let years = Years(42);
    let years_as_primitive_1: i64 = years.0; // Tuple
    let Years(years_as_primitive_2) = years; // Destructuring
}

另见

结构体