# tuple
Element wise operations on tuples!
# [Documentation](https://docs.rs/tuple)
This crate allows to generalize operations to tuples using macros.
# Examples
```rust
extern crate tuple;
use tuple::*;
```
## Element-wise operations
```rust
let a = T2(3, 4) + T2(5, 4);
assert_eq!(a, T2(8, 8));
let b = T2(3u32, 4.0f32) * T2(7, 3.0);
assert_eq!(b, T2(21, 12.));
```
## Indexing
This is implemented in the [`TupleElements`](trait.TupleElements.html) trait.
Indexing works as expected and panics when out of bounds.
There are also `get` and `get_mut` functions that return `Option<&T>` and `Option<&mut T>`.
```rust
assert_eq!(T3(1, 2, 3)[2], 3);
assert_eq!(T2(7, 8).get(1), Some(8));
assert_eq!(T2(7, 8).get(2), None);
```
## Adding a Trait
```rust
#[macro_use]
extern crate tuple;
extern crate num_traits;
use tuple::*;
use num_traits::Zero;
use std::ops::{Add, Sub, Mul};
use std::fmt::Debug;
trait Ring: Add + Sub + Mul + Zero + Debug + Sized {}
// The name is up to you
macro_rules! impl_ring {
// This line is defined by this crate and can't be changed
($($Tuple:ident { $($idx:tt -> $T:ident),* } )*) => ($(
// This is expanded for every Tuple type
impl<$($T),*> Ring for $Tuple<$($T),*> where Self: Zero, $( $T: Ring ),* {}
// this has to match again
)*)
}
// actually implement it!
impl_tuple!(impl_ring);
```