1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

use super::Pattern;

/// Trait implemented for types that can do pattern search.
pub trait PatternSearcher {
    /// Pattern search output.
    type Output;
    /// Iterator over all occurences.
    type Iter: Iterator<Item = Self::Output>;

    /// Finds an iterator over all occurences of the pattern.
    fn find_all(&self, pat: Pattern) -> crate::Result<Self::Iter>;

    /// Returns first occurence of the pattern if present.
    fn find_first(&self, pat: Pattern) -> crate::Result<Option<Self::Output>> {
        Ok(self.find_all(pat)?.next())
    }
}