rustc_data_structures/binary_search_util/
mod.rs

1#[cfg(test)]
2mod tests;
3
4/// Uses a sorted slice `data: &[E]` as a kind of "multi-map". The
5/// `key_fn` extracts a key of type `K` from the data, and this
6/// function finds the range of elements that match the key. `data`
7/// must have been sorted as if by a call to `sort_by_key` for this to
8/// work.
9pub fn binary_search_slice<'d, E, K>(data: &'d [E], key_fn: impl Fn(&E) -> K, key: &K) -> &'d [E]
10where
11    K: Ord,
12{
13    let size = data.len();
14    let start = data.partition_point(|x| key_fn(x) < *key);
15    // At this point `start` either points at the first entry with equal or
16    // greater key or is equal to `size` in case all elements have smaller keys
17    if start == size || key_fn(&data[start]) != *key {
18        return &[];
19    };
20
21    // Find the first entry with key > `key`. Skip `start` entries since
22    // key_fn(&data[start]) == *key
23    let offset = start + 1;
24    let end = data[offset..].partition_point(|x| key_fn(x) <= *key) + offset;
25
26    &data[start..end]
27}