#vec #extension #entry

no-std vec-entries

Entry API for iterating over and removing elements from a Vec

1 stable release

1.0.0 May 27, 2024

#1057 in Data structures

MIT license

28KB
442 lines

vec-entries

Crates.io Workflow Status

Entry API for iterating over and removing elements from a Vec.

Description

Sometimes you want to do efficently remove and modify elements of a Vec in a slightly more complex way than Vec::dedup_by, Vec::retain, or Vec::drain enable. This crate aims to target a similar, but more expansive functionality.

Usage

Just import the extension trait and call the new method. The EntriesExt::entries enables iterating across elements, mutating, removing, and re-inserting as needed. Like Vec::dedup_by this is done by passing in a function which take an Entries object and returns anything.

use vec_entries::EntriesExt;

let mut v = vec![1, 2, 3];
let c = v.entries(.., |e| {
    let a = e.remove().unwrap();      // Remove the `1`
    let b = e.remove_back().unwrap(); // Remove the `3`
    e.try_insert_outside(0);          // Insert a `0` where we removed the `1`
    a + b
});
assert_eq!(c, 4);
assert_eq!(v, [0, 2]);

License

Licensed under

No runtime deps