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
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

//! Tydi common traits.

/// In-place reverse.
///
/// # Implementing `Reverse`
///
/// ```rust
/// use tydi::{Reverse, Reversed};
///
/// #[derive(Clone, Copy, Debug, PartialEq)]
/// struct A {
///     in_port: bool,
///     size: u32,
/// }
///
/// impl Reverse for A {
///     fn reverse(&mut self) {
///         self.in_port = !self.in_port;
///     }
/// }
///
/// let mut a = A { in_port: false, size: 42 };
/// a.reverse();
/// assert!(a.in_port);
/// a.reverse();
/// assert!(!a.in_port);
/// let b = A { in_port: true, size: 42 };
/// assert_eq!(a.reversed(), b);
/// ```
pub trait Reverse {
    /// Reverse in-place.
    fn reverse(&mut self);
}

/// Construct reversed items.
pub trait Reversed {
    /// Returns a new reversed instance.
    fn reversed(&self) -> Self;
}

impl<T> Reversed for T
where
    T: Reverse + Clone,
{
    /// Returns a new reversed instance by cloning and reversing the clone
    /// in-place.
    fn reversed(&self) -> T {
        let mut r = self.clone();
        r.reverse();
        r
    }
}

/// Trait for things that have names.
pub trait Identify {
    fn identifier(&self) -> &str;
}