Struct EventQueue 

pub struct EventQueue { /* private fields */ }

Priority queue for discrete events in simulation.

Uses a min-heap to efficiently schedule and retrieve events by time. Events at the same time are ordered by their sequence number (FIFO within same time).

Implementations

impl EventQueue

pub fn new() -> Self

Create a new empty event queue.

pub fn with_capacity(capacity: usize) -> Self

Create with initial capacity.

pub fn schedule(&mut self, time: i64, event_type: u32, payload: u64)

Schedule an event at a future time.

Arguments

• time - Scheduled time (Unix microseconds)
• event_type - User-defined event type ID
• payload - Event payload (NaN-boxed value)

pub fn pop_due(&mut self, current_time: i64) -> Option<ScheduledEvent>

Pop the next event that is due (scheduled_time <= current_time).

Returns None if no events are due.

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

Peek at the next event without removing it.

pub fn has_due_events(&self, current_time: i64) -> bool

Check if any events are due.

pub fn len(&self) -> usize

Number of pending events.

pub fn is_empty(&self) -> bool

Check if queue is empty.

pub fn clear(&mut self)

Clear all pending events.

pub fn drain_due(&mut self, current_time: i64) -> Vec<ScheduledEvent>

Drain all events due at or before current_time.

Trait Implementations

impl Debug for EventQueue

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

Formats the value using the given formatter.

impl Default for EventQueue

fn default() -> Self

Returns the “default value” for a type.