Struct EventScheduler 

pub struct EventScheduler { /* private fields */ }

Priority-ordered event queue.

Ensures deterministic processing order:

1. Events are sorted by time
2. Ties are broken by sequence number (insertion order)

Example

use simular::engine::scheduler::EventScheduler;
use simular::engine::SimTime;
use simular::engine::state::{SimEvent, Vec3};

let mut scheduler = EventScheduler::new();

scheduler.schedule(
    SimTime::from_secs(1.0),
    SimEvent::AddBody {
        mass: 1.0,
        position: Vec3::zero(),
        velocity: Vec3::zero(),
    },
);

Implementations

impl EventScheduler

pub fn new() -> Self

Create a new event scheduler.

pub fn schedule(&mut self, time: SimTime, event: SimEvent)

Schedule an event at the given time.

pub fn schedule_all(&mut self, time: SimTime, events: &[SimEvent])

Schedule multiple events at the same time.

Events will be processed in the order they appear in the slice.

pub fn next(&mut self) -> Option<ScheduledEvent>

Get the next event (removes from queue).

pub fn peek(&self) -> Option<&ScheduledEvent>

Peek at the next event without removing it.

pub fn next_before(&mut self, time: SimTime) -> Option<ScheduledEvent>

Get the next event if its time is before or at the given time.

pub fn drain_until(&mut self, time: SimTime) -> Vec<ScheduledEvent>

Get all events up to and including the given time.

pub fn is_empty(&self) -> bool

Check if the queue is empty.

pub fn len(&self) -> usize

Get the number of pending events.

pub fn clear(&mut self)

Clear all pending events.

pub fn next_event_time(&self) -> Option<SimTime>

Get the time of the next event, if any.

Trait Implementations

impl Debug for EventScheduler

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

Formats the value using the given formatter.

impl Default for EventScheduler

fn default() -> EventScheduler

Returns the “default value” for a type.