Struct BruteForce 

pub struct BruteForce<Insn, InputParameters, ReturnValue: Clone, TargetFunction: Callable<InputParameters, ReturnValue>, Searchable: Callable<InputParameters, ReturnValue> + BruteforceSearch<Insn>> {
    pub count: usize,
    /* private fields */
}

Performs a brute force search over a given search space Searchable

Fields

count: usize

Keeps track of how many iterations the bruteforce search has been through.

Implementations

impl<Insn, InputParameters: Copy + Vals, ReturnValue: Vals + PartialEq + Clone, TargetFunction: Callable<InputParameters, ReturnValue>, Searchable: Callable<InputParameters, ReturnValue> + BruteforceSearch<Insn> + Clone> BruteForce<Insn, InputParameters, ReturnValue, TargetFunction, Searchable>

pub fn new( target_function: TargetFunction, initial_candidate: Searchable, ) -> Self

Constructs a new BruteForce

pub fn candidate(&self) -> &Searchable

Returns the candidate currently under consideration

pub fn step(&mut self) -> IterationResult

Advances the candidate to the next position in the search space

pub fn test(&mut self) -> bool

Tests that the candidate matches the target function

pub fn search(&mut self) -> Option<Searchable>

Returns the next function that matches the target function

Examples found in repository

examples/ng.rs (line 21)

fn main() {
    let target_function = zero as fn(u8) -> RunResult<u8>;

    // do a bruteforce search for Z80 machine code programs implementing the same function
    let mut bruteforce = strop::mips::O32::default()
        .trace()
        .to_bruteforce(target_function);

    let bf = bruteforce.search().unwrap();

    println!("An equivalent subroutine we found by bruteforce search,");
    println!("after {} iterations.", bruteforce.count);
    bf.dasm();
}

Trait Implementations

impl<Insn: Clone, InputParameters: Clone, ReturnValue: Clone + Clone, TargetFunction: Clone + Callable<InputParameters, ReturnValue>, Searchable: Clone + Callable<InputParameters, ReturnValue> + BruteforceSearch<Insn>> Clone for BruteForce<Insn, InputParameters, ReturnValue, TargetFunction, Searchable>

fn clone( &self, ) -> BruteForce<Insn, InputParameters, ReturnValue, TargetFunction, Searchable>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Insn: Debug, InputParameters: Debug, ReturnValue: Debug + Clone, TargetFunction: Debug + Callable<InputParameters, ReturnValue>, Searchable: Debug + Callable<InputParameters, ReturnValue> + BruteforceSearch<Insn>> Debug for BruteForce<Insn, InputParameters, ReturnValue, TargetFunction, Searchable>

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

Formats the value using the given formatter.