Synonym

概述

该 synonym 库是一个 Rust 包，旨在简化新类型的创建。它提供了一个可定制的 #[derive(Synonym)] 宏，它根据新类型的底层类型自动实现各种特质。这为您在定义新类型时节省了通常需要的样板代码。

使用方法

要使用 synonym，将其添加到您的 Cargo.toml 中

[dependencies]
synonym = "0.1.5"

基本示例

将 Synonym 特质导入到您的 Rust 文件中

use synonym::Synonym;

然后，定义您的 newtype 并用 #[derive(Synonym)] 注释它

#[derive(Synonym)]
pub struct MyInt(i32);

使用属性进行自定义

您可以使用 #[synonym(skip(...))] 和 #[synonym(force(...))] 属性来自定义实现的特质或跳过的特质

#[derive(Synonym)]
#[synonym(skip(Eq, PartialEq))]
pub struct MyString(String);

支持的 skip 和 force 值列在下面的 特质实现表 中。

生成的代码

当您使用#[derive(Synonym)]时，库会为各种特质生成实现。以下是一个针对新类型(i32)的简化示例。

impl Eq for MyInt {}
impl PartialEq for MyInt {
    fn eq(&self, other: &Self) -> bool {
        self.0 == other.0
    }
}
// ... and so on for other traits

特质实现表

自定义方法

转换

基本特质

比较

Serde [6]

数学 [7]

[1] 整数包括：u8、u16、u32、u64、u128、usize、i8、i16、i32、i64、i128、isize [2] .value() 对于Copy类型返回&Inner，对于非Copy类型返回&Inner [3] Deref和DerefMut不会实现，除非使用#[synonym(force(deref,deref_mut))]强制 [4] 与其他字符串不同，FromStr对于Box<str>同义词使用Inner::From<&'str>而不是Inner::FromStr，因为不存在Box<str>的Inner::FromStr实现 [5] 显示实现可以配置，见下文 [6] 当启用功能with_serde时才提供 [7] 这可能发生变化

#[derive(Synonym)]
#[synonym(display = "UpperCase")]
struct CountryName(String);

#[derive(Synonym)]
#[synonym(display = "::<> {} <>::")]
struct Turbo(String);

[dependencies]
synonym = { version = "0.1.5", features = ["with_serde"] }