basic_pattern_scanner 1.0.1

Fast no-dependencies byte-pattern scanner with IDA-style and nibble-mask pattern support
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

use crate::{
	pattern::types::Pattern,
	scanner::types::{Match, MatchWithAddr},
};

/// Trait for base implementation for different types of scanners.
pub trait PatternIterator {
	fn scan_all<'a>(
		&self,
		data: &'a [u8],
		pattern: &'a Pattern,
	) -> Box<dyn Iterator<Item = Match> + 'a>;

	/// This is a convienience function which calculates the offset + base and gives back both
	fn scan_all_with_base<'a>(
		&self,
		data: &'a [u8],
		pattern: &'a Pattern,
		base: u64,
	) -> Box<dyn Iterator<Item = MatchWithAddr> + 'a> {
		Box::new(
			self
				.scan_all(data, pattern)
				.map(move |_match| MatchWithAddr {
					offset: _match.offset,
					address: base + _match.offset as u64,
				}),
		)
	}

	/// This is a convienience function which collects the full iterator from `scan_all` into an
	/// `Vec<MatchWithAddr>`
	fn find_all(&self, data: &[u8], pattern: &Pattern) -> Vec<Match> {
		self.scan_all(data, pattern).collect()
	}

	/// This is a convienience function which collects the full iterator from `scan_all_with_base` into an
	/// `Vec<MatchWithAddr>`
	fn find_all_with_base(&self, data: &[u8], pattern: &Pattern, base: u64) -> Vec<MatchWithAddr> {
		self.scan_all_with_base(data, pattern, base).collect()
	}
}