sort_by_derive

• sort_by_derive
  • 用法
    • SortBy
    • 枚举访问器
      • 字段访问器
    • 枚举序列
      • 示例

此crate提供3个派生宏 SortBy、EnumAccessor 和 EnumSequence。

• SortBy 为无法自动派生这些特质的结构派生特质 Ord、PartialOrd、Eq、PartialEq 和 Hash。
• 在枚举和结构体上，SortBy 还可以实现一个调用任意方法的 Ord 特质，这特别适用于与由 EnumAccessor 和 EnumSequence 派生的枚举变体访问方法结合使用。
• EnumAccessor 为变体中的常用字段派生访问器方法，因此您无需编写自己的 match 语句来访问具有相同名称和类型的字段。此功能类似于 enum_dispatch，但采用不同的方法，其中结构体不需要实现特质。
• EnumSequence 提供了一个 enum_sequence 方法，其中第一个变体返回 0，第二个返回 1，依此类推。这在需要实现自定义排序时很有用，同时变体声明的顺序仍然是作为次要排序依据。

用法

SortBy

应用于排序的字段使用属性 #[sort_by] 标记。其他字段将被忽略。

use std::cmp::Ordering;
use sort_by_derive::SortBy;

#[derive(SortBy)]
struct Something {
    #[sort_by]
    a: u16,
    b: u16
}

assert_eq!(Something{a: 2, b: 0}.cmp(&Something{a: 1, b: 1}), Ordering::Greater); // a is compared
assert_eq!(Something{a: 1, b: 0}.cmp(&Something{a: 1, b: 1}), Ordering::Equal); // b is ignored

枚举访问器

此 derive 宏与 enum_dispatch 类似。 enum_dispatch 要求结构体实现一个公共特质，如果一组公共函数适用于所有变体，这可能会很有用。 EnumAccessor 采取了相反的方法：公共字段和方法在枚举级别声明，并且可以存在没有给定字段或方法的变体。如果变体数量很多，而你只关心访问字段，这可能更实用，因为单个结构体仅包含数据。这通常适用于事件——它们代表状态变化，通常作为一个整体被消费，单个结构体没有自己的代码。

字段访问器

在枚举上添加 derive(EnumAccessor) 之后，字段将声明为 accessor(field: type) 属性。

这将推导出访问器方法 fn name(&self) -> &type; 和 fn name_mut(&mut self) -> &mut type;，并返回任何变体上同名字段的引用。

use sort_by_derive::EnumAccessor;

#[derive(EnumAccessor)]
#[accessor(a: u16)]
#[accessor(b: u16)]
enum E {
    Variant1{a: u16, b: u16},
    Variant2{a: u16, b: u16, c: u32},
}

let v1 = E::Variant1{a: 1, b: 1};
let mut v2 = E::Variant2{a: 1, b: 1, c: 2};

// Accessor methods are generated for the specified members
assert_eq!(*v1.a(), 1);
assert_eq!(*v2.b(), 1);

// Mutable accessors are also generated
*v2.a_mut() = 2;
assert_eq!(*v2.a(), 2);

use sort_by_derive::EnumSequence;

#[derive(EnumSequence)]
enum ABC {
    A(u8),
    B(String),
    C { f: String, g: usize }
}

assert_eq!(ABC::B("hi!".into()).enum_sequence(), 1);