neure 0.10.1

A fast little combinational parsing library
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
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

use core::fmt::Debug;
use core::marker::PhantomData;

use super::Neu;

use crate::MayDebug;

pub struct Always<T>(PhantomData<T>);

impl<T: MayDebug> core::ops::Not for Always<T> {
    type Output = crate::neu::Not<Self, T>;

    fn not(self) -> Self::Output {
        crate::neu::not(self)
    }
}

impl<T> Debug for Always<T> {
    fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
        f.debug_tuple("Always").field(&self.0).finish()
    }
}

impl<T> Default for Always<T> {
    fn default() -> Self {
        Self(Default::default())
    }
}

impl<T> Clone for Always<T> {
    fn clone(&self) -> Self {
        *self
    }
}

impl<T> Copy for Always<T> {}

impl<T> Always<T> {
    pub const fn new() -> Self {
        Self(PhantomData)
    }
}

impl<T: MayDebug> Neu<T> for Always<T> {
    #[inline(always)]
    fn is_match(&self, _other: &T) -> bool {
        crate::trace_retval!("Always", _other, true)
    }
}

/// Always return true.
///
/// # Example
/// ```
/// # use neure::prelude::*;
/// #
/// # fn main() {
///   let always = neu::always();
///   let mut ctx = CharsCtx::new("abc%$#&");
///
///   assert_eq!(ctx.try_mat(&always.count::<6>()).unwrap(), Span::new(0, 6));
/// # }
/// ```
pub const fn always<T: MayDebug>() -> Always<T> {
    Always(PhantomData)
}

pub struct Never<T>(PhantomData<T>);

impl<T: MayDebug> core::ops::Not for Never<T> {
    type Output = crate::neu::Not<Self, T>;

    fn not(self) -> Self::Output {
        crate::neu::not(self)
    }
}

impl<T> Debug for Never<T> {
    fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
        f.debug_tuple("Never").field(&self.0).finish()
    }
}

impl<T> Default for Never<T> {
    fn default() -> Self {
        Self(Default::default())
    }
}

impl<T> Clone for Never<T> {
    fn clone(&self) -> Self {
        *self
    }
}

impl<T> Copy for Never<T> {}

impl<T> Never<T> {
    pub const fn new() -> Self {
        Self(PhantomData)
    }
}

impl<T: MayDebug> Neu<T> for Never<T> {
    #[inline(always)]
    fn is_match(&self, _other: &T) -> bool {
        crate::trace_retval!("Never", _other, false)
    }
}

/// Always return false.
///
/// # Example
/// ```
/// # use neure::prelude::*;
/// #
/// # fn main() {
///   let never = neu::never();
///   let mut ctx = CharsCtx::new("abc%$#&");
///
///   assert!(ctx.try_mat(&never.count::<6>()).is_err());
/// # }
/// ```
pub const fn never<T: MayDebug>() -> Never<T> {
    Never(PhantomData)
}