segmap

segmap 暴露了 SegmentMap，这是一个键存储为范围的映射数据结构。映射到相同值的连续和重叠范围将被合并为单个范围。

还提供了一个相应的 SegmentSet 结构。

类型 Segment<T>

SegmentMap 支持同一映射中所有类型的输入范围类型，并将它们都强制转换为内部表示的公共范围类型。类型 Segment<T> 始终表示为递增的，因此“反向”范围将在插入时反转。

大多数 SegmentMap 和 SegmentSet 上的方法接受一个泛型参数用于范围，只需实现 RangeBounds 即可。

示例：与 Chrono 一起使用

use chrono::offset::TimeZone;
use chrono::{Duration, Utc};
use segmap::SegmentMap;

let people = ["Alice", "Bob", "Carol"];
let mut roster = SegmentMap::new();

// Set up initial roster.
let start_of_roster = Utc.ymd(2019, 1, 7);
let mut week_start = start_of_roster;
for _ in 0..3 {
    for person in people {
        let next_week = week_start + Duration::weeks(1);
        roster.insert(week_start..next_week, person);
        week_start = next_week;
    }
}

// Bob is covering Alice's second shift (the fourth shift overall).
let fourth_shift_start = start_of_roster + Duration::weeks(3);
let fourth_shift_end = fourth_shift_start + Duration::weeks(1);
roster.insert(fourth_shift_start..fourth_shift_end, "Bob");

// Print out the roster, and observe that
// the fourth and fifth shifts have been coalesced
// into one range.
for (range, &person) in roster.iter() {
    let start = *range.start_value().unwrap();
    let duration = *range.end_value().unwrap() - start;
    println!("{} ({}): {}", start, duration, person);
}

// Output:
// 2019-01-07UTC (P7D): Alice
// 2019-01-14UTC (P7D): Bob
// 2019-01-21UTC (P7D): Carol
// 2019-01-28UTC (P14D): Bob
// 2019-02-11UTC (P7D): Carol
// 2019-02-18UTC (P7D): Alice
// 2019-02-25UTC (P7D): Bob
// 2019-03-04UTC (P7D): Carol

在没有 Rust 标准库的情况下构建

这个 crate 可以在没有完整标准库的情况下工作（例如在没有任何操作系统的裸机设备上运行），但依赖于全局分配器的存在——即它链接了 core 和 alloc crate，但没有 std。

目前该 crate 中没有需要标准库的功能。此类功能可能会在未来引入，并将通过默认启用的 std 功能进行限制。

有关在没有标准库的情况下操作的一般信息，请参阅 《Rust 编程语言》 书籍。