into_index 0.2.0

Helper traits allowing indexing into vectors and similar types by other types than `usize`
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

# `IntoIndex`

Sometimes it is more convenient to use another type than `usize` to calculate and store
indices.  This crate provides an `IntoIndex` trait that can be used to convert any type into
an `usize`. For types that implement `TryInto<usize>` this is already implented.  Naturally
some of these conversions are fallible,​ the `into_index()` method may panic in this case. A
`try_into_index()` method that returns a `Result` for handling such errors are available as
well.

# `At` and `AtMut`

Further the `At` and `AtMut` traits use `IntoIndex` for providing indexing without the
associated `Output` type that is required for the `Index` and `IndexMut` traits.  These
are implented for all types implementing `AsRef<[T]>` and `AsMut<[T]>` respectively.  This
allows for indexing into slices, vectors, arrays and other types that implement these traits.


# Example

```
use into_index::{IntoIndex, At};
let v = vec![1,2,3];

assert_eq!(*v.at(1u8), 2);
```