用法

在Cargo.toml文件中，在[dependencies]下插入：sets = "^1"
在源文件中的以下'使用'声明使所有内容可用

use sets::{Set,MutSetOps};

Set<T>

/// The struct type for sets
#[derive(Default)]
pub struct Set<T> {
    /// type of the set
    pub stype: SType,
    /// order: ascending (true), descending (false)
    pub ascending: bool,
    /// data Vec
    pub data: Vec<T>,
    /// index Vec
    pub index: Vec<usize>
}

Clone和Display特性能为Set和SType实现。
Default被推导出来，因此Default::default()生成一个空集。

SType指定五种集合中的一种。它通过'枚举泛型'处理。

/// The five types of sets
#[derive(Default,Clone,Copy)]
pub enum SType {
    /// empty set
    #[default]
    Empty,
    /// unordered set
    Unordered,
    /// ordered set
    Ordered,
    /// indexed set
    Indexed,
    /// ranked set
    Ranked
}

关联初始化器

初始化器与struct Set相关联，因此要调用它们，需要使用::语法，例如：Set::new(..)

    /// all in one Initialiser: creates a new Set
    /// of any self_type SType, from slice d, in asc order 
    pub fn new(set_type: SType, d: &[T], asc:bool) -> Self

对于所有STypes，也存在显式命名的便利函数：new_empty, new_unordered, new_ordered, new_indexed, new_ranked。所有有序类型（即有序、索引、排名）都接受一个bool参数来指定升序或降序。

转换器

    /// General converter - 
    /// converts s to a Set of the same type and order as self 
    /// (self only serves as a template).
    pub fn to_same(&self, s:&Self) -> Self 

同样，我们有显式命名的转换器：to_unordered, to_ordered, to_indexed, to_ranked。

   let v = vec![1.,14.,2.,13.,3.,12.];
   let setv = Set::new_unordered(&v);  
   println!("{}",setv); // Display setv 
   // ordered, ascending  
   println!("{}",setv.to_ordered(true)); 
   // indexed, descending
   println!("{}",setv.to_indexed(false)); 

强烈建议阅读并运行tests/tests.rs以获取更多使用示例。使用单个线程运行它们。这可能会稍微慢一些，但会将结果写入正确的顺序

cargo test --release -- --test-threads=1 --nocapture --color always

可以通过点击上面的最后一个徽章并查看其中的自动化测试日志来查看输出。

集合函数

一些通用方法对于有序和索引集合来说更有效率，而不是无序集合。例如，member和search将自动使用二分搜索。并集类似于经典合并，其中集合之间的重复项被删除。要删除集合内部的重复项，请使用nonrepeat。

并集、交集和差集的两个操作数的STypes可以不同。然而，它们需要具有相同的末尾类型<T>。这可能是一种有用的类型纪律。