try-traits 0.1.1

Alternatives to std lib traits that can fail.
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
27
28
29
30
31
32
33
34

use core::ops::{Index, IndexMut};

///
pub trait TryIndex<Idx> {
	/// The type returned in the event of an error.
	type Error;

	/// The type returned after performing the operation.
	type Output: ?Sized;

	/// The fallible equivalent of [`Index::index`].
	fn try_index(&self, index: Idx) -> Result<&Self::Output, Self::Error>;
}

/// The try trait for [`IndexMut`].
pub trait TryIndexMut<Idx> : TryIndex<Idx> {
	/// The fallible equivalent of [`Index::index`].
	fn try_index_mut(&mut self, index: Idx) -> Result<&mut Self::Output, Self::Error>;
}

impl<T: Index<Idx>, Idx> TryIndex<Idx> for T {
	type Error = crate::Infallible;
	type Output = <Self as Index<Idx>>::Output;

	fn try_index(&self, index: Idx) -> Result<&Self::Output, Self::Error> {
		Ok(self.index(index))
	}
}

impl<T: IndexMut<Idx>, Idx> TryIndexMut<Idx> for T {
	fn try_index_mut(&mut self, index: Idx) -> Result<&mut Self::Output, Self::Error> {
		Ok(self.index_mut(index))
	}
}