Crate index_many[][src]

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

This module contains example functions with the generated assembly in their docs.

A generic variant of the API, that can be indexed by any type implementing Indices<N>.

A simple variant of the API, that expects an array of [usize; N] indices.

A variant of the simple API that returns a Result instead.

A variant of the API that also works with ranges.