Struct EnvHandle 

pub struct EnvHandle { /* private fields */ }

A lightweight handle to the simulation environment, intended to be cloned and passed into spawned processes.

Both SimEnv and all EnvHandle clones share the same underlying SimState and the same RandomSource.

Implementations

impl EnvHandle

pub fn now(&self) -> f64

Current simulation time.

pub fn rng(&self) -> impl RngCore + '_

Borrow the shared RNG mutably.

The returned guard implements rand::RngCore, so it works with the rng::sample transforms and with rand_distr distributions alike. Sample before awaiting — the guard cannot be held across an .await point.

use simu::{SimEnv, rng::sample};
let env = SimEnv::with_seed(0);
let h = env.handle();
let duration = sample::exponential(&mut h.rng(), 20.0); // mean = 20
assert!(duration >= 0.0);

pub fn timeout(&self, delay: f64) -> Timeout

Create a Timeout that resolves after delay simulated time units.

The deadline is computed when the Timeout is created (now() + delay), not when it is first awaited — relevant when a Timeout is stored and raced later inside any_of!.

Panics

Panics if delay is negative or not finite (NaN / infinity). Simulated time is monotonic, so a negative delay is a programming error; a zero delay is allowed and fires on the next event-loop iteration.

pub fn event(&self) -> (EventTrigger, EventAwaitable)

Create a paired (EventTrigger, EventAwaitable) for inter-process signalling.

pub fn spawn<F>(&self, future: F) -> ProcessHandle<F::Output>

where F: Future + 'static, F::Output: 'static,

Spawn a child process from within a running process.

Returns a ProcessHandle that resolves to the process’s output when it finishes. Drop the handle to detach (fire-and-forget).

Trait Implementations

impl Clone for EnvHandle

fn clone(&self) -> EnvHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EnvHandle

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

Formats the value using the given formatter.