Struct Pattern 

pub struct Pattern { /* private fields */ }

A byte pattern used for scanning memory regions.

Patterns consist of exact byte matches and wildcard positions. They can be constructed from IDA-style signature strings or code-style byte/mask pairs.

Implementations

impl Pattern

pub fn from_ida(signature: &str) -> Result<Self>

Creates a pattern from an IDA-style signature string.

Each token is separated by whitespace. Exact bytes are specified as two-character hex values. Wildcards are represented by ? or ??.

use procmod_scan::Pattern;

let pattern = Pattern::from_ida("48 8B ?? 89 ? 0F").unwrap();

pub fn from_code(bytes: &[u8], mask: &str) -> Result<Self>

Creates a pattern from a code-style byte/mask pair.

The mask string uses x for exact byte matches and ? for wildcards, one character per byte. The mask length must equal the bytes length.

use procmod_scan::Pattern;

let pattern = Pattern::from_code(b"\x48\x8B\x00\x89", "xx?x").unwrap();

pub fn from_tokens(tokens: Vec<Token>) -> Result<Self>

Creates a pattern from raw tokens.

Returns an error if the token list is empty.

pub fn tokens(&self) -> &[Token]

Returns the tokens in this pattern.

pub fn len(&self) -> usize

Returns the number of tokens in this pattern.

pub fn is_empty(&self) -> bool

Returns true if the pattern has no tokens.

pub fn scan(&self, data: &[u8]) -> Vec<usize>

Finds all offsets in data where this pattern matches.

Returns an empty vec if no matches are found. Matches may overlap.

pub fn scan_first(&self, data: &[u8]) -> Option<usize>

Finds the first offset in data where this pattern matches.

Returns None if no match is found.

Trait Implementations

impl Clone for Pattern

fn clone(&self) -> Pattern

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Pattern

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

Formats the value using the given formatter.