Crate index_many

Crate index_many 

Source
Expand description

Proof of concept functions for (mutably) accessing a slice at multiple positions at once via an array of indices.

§Provided APIs

This crate implements multiple APIs:

  • “simple”: accepts a sorted array [usize; N] of indices.
  • “simple_result”: accepts a sorted array [usize; N] of indices, but with an Result based API.
  • “slice_index”: accepts a sorted array [I; N] of indices, where I: SliceIndex<[T]>.
  • “generic”: uses a generic I: Indices<N> that allows for more flexibility.

§Example

use index_many::generic::index_many_mut;

let mut v = vec![1, 2, 3, 4, 5];
let [a, b, c] = index_many_mut(&mut v, [0, 2, 4]);
*a += 10;
*b += 100;
*c += 1000;
assert_eq!(v, vec![11, 2, 103, 4, 1005]);

§Generated Assembly

The docs contain example functions with their x86_64 assembly codegen. See the crate::_doc_assembly module.

Modules§

_doc_assembly
This module contains example functions with the generated assembly in their docs.
generic
A generic variant of the API, that can be indexed by any type implementing Indices<N>.
simple
A simple variant of the API, that expects an array of [usize; N] indices.
simple_result
A variant of the simple API that returns a Result instead.
slice_index
A variant of the API that also works with ranges.
std_proposal