Struct Pattern 

pub struct Pattern { /* private fields */ }

A wildcard byte pattern with parsed-from-string ergonomics.

Internally just a Vec<Option<u8>> for owned, runtime-built patterns. For static / compile-time patterns prefer the crate::pattern! macro, which produces a &'static [Option<u8>] with no allocation.

Examples

use pe_sigscan::Pattern;

let p = Pattern::from_ida("48 8B 05 ?? ?? ?? ?? 48 89 41 08").unwrap();
assert_eq!(p.len(), 11);
assert_eq!(p.as_slice()[0], Some(0x48));
assert_eq!(p.as_slice()[3], None);

Implementations

impl Pattern

pub fn new(bytes: Vec<Option<u8>>) -> Self

Construct a pattern from an existing Vec<Option<u8>>.

Useful when the pattern is built programmatically (e.g. mutating an existing Vec<Option<u8>> to add wildcards before scanning).

pub fn from_ida(s: &str) -> Result<Self, ParsePatternError>

Parse an IDA-style hex pattern string.

Accepted token shapes (case-insensitive, separated by ASCII whitespace):

• XX — two hex digits, matches the literal byte 0xXX.
• ? or ?? — wildcard, matches any byte.

Examples

use pe_sigscan::Pattern;
let p = Pattern::from_ida("48 8B ?? 89").unwrap();
assert_eq!(p.as_slice(), &[Some(0x48), Some(0x8B), None, Some(0x89)]);

Errors

Returns ParsePatternError if the input contains a token that is neither two hex digits nor ? / ??, or if a token mixes ? with hex characters (?A, 1?).

pub fn as_slice(&self) -> WildcardPattern<'_>

View the pattern as a WildcardPattern. Use this when calling the scan functions: find_in_text(base, pat.as_slice()).

pub fn len(&self) -> usize

Number of byte slots in the pattern (literal + wildcard).

pub fn is_empty(&self) -> bool

true if the pattern is empty.

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.

impl PartialEq for Pattern

fn eq(&self, other: &Pattern) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Pattern

impl StructuralPartialEq for Pattern