breaktarget

The breaktarget module defines one type: The BreakTarget type. A value of this type may be obtained by invoking BreakTarget::deploy.

BreakTarget::deploy takes a lambda, which is passed a reference to a BreakTarget. This object defines a single method, break_with, which takes a value of type T and returns control flow to the site of the BreakTarget::deploy call, producing the value as the result. If the lambda exits normally, it must also produce a value of type T, which is produced as the result of the BreakTarget::deploy call.

Important Notes

The nonlocal breaking is implemented using a panic to unwind the stack. Any open Mutexes which are closed by this unwinding will be poisoned, among with other unwinding specific effects.

If panic = "abort" is enabled, calls to break_with will abort the program

Examples

```rust use breaktarget::Breaktarget;

let result = BreakTarget::deploy(|target| { // ... Some logic here target.breakwith(10i32); // ... Some logic here }); asserteq!(result, 10i32); ```

```rust use breaktarget::BreakTarget;

fn somefunction(target: &BreakTarget, cond: bool) { if cond { target.breakwith(10); } }

let result1 = BreakTarget::deploy(|target| { somefunction(target, false); 20 }); asserteq!(result1, 20);

let result2 = BreakTarget::deploy(|target| { somefunction(target, true); 20 }); asserteq!(result2, 10); ```