Struct aob::DynamicNeedle

pub struct DynamicNeedle { /* private fields */ }

The run-time variant of a Needle.

Implementations

impl DynamicNeedle

pub fn from_ida(pattern: &str) -> Result<DynamicNeedle, Error<'_>>

Construct a DynamicNeedle using an Ida style pattern.

Syntax

Expects a sequence of byte or wildcard separated by whitespace, where:

• byte is exactly 2 hexadecimals (uppercase or lowercase), indicating an exact match
• wildcard is one or two ? characters, indicating a fuzzy match

Example

let needle = DynamicNeedle::from_ida("78 ? BC").unwrap();
let haystack = [0x12, 0x34, 0x56, 0x78, 0x9A, 0xBC, 0xDE];
let matched = needle.find(&haystack).unwrap();
assert_eq!(&haystack[matched.start()..], [0x78, 0x9A, 0xBC, 0xDE]);

pub fn from_bytes(bytes: &[Option<u8>]) -> DynamicNeedle

Contruct a DynamicNeedle using raw bytes, in plain Rust.

Syntax

Expects an array of Option<u8>, where:

• Some(_) indicates an exact match
• None indicates a fuzzy match

Example

let needle = DynamicNeedle::from_bytes(&[Some(0x78), None, Some(0xBC)]);
let haystack = [0x12, 0x34, 0x56, 0x78, 0x9A, 0xBC, 0xDE];
let matched = needle.find(&haystack).unwrap();
assert_eq!(&haystack[matched.start()..], [0x78, 0x9A, 0xBC, 0xDE]);

Trait Implementations

impl Clone for DynamicNeedle

fn clone(&self) -> DynamicNeedle

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DynamicNeedle

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Needle for DynamicNeedle

fn find_iter<'needle, 'haystack>( &'needle self, haystack: &'haystack [u8], ) -> Find<'needle, 'haystack>

Finds all matching subsequences, iteratively.

fn len(&self) -> usize

The length of the needle itself.

fn find<'haystack>(&self, haystack: &'haystack [u8]) -> Option<Match<'haystack>>

A convenience method for getting only the first match.