Struct TimeWindow 

pub struct TimeWindow { /* private fields */ }

Time window for tracking events within a specific time period.

Examples

use chie_shared::TimeWindow;

let mut window = TimeWindow::new(1000, 100); // 1 second window, max 100 events

// Track events at different timestamps
window.add_event(1000);
window.add_event(1100);
window.add_event(1200);

// Count events within the window
assert_eq!(window.count_events(1500), 3);

// Events older than window size are cleaned up
assert_eq!(window.count_events(2500), 0);

// Check rate limiting
let mut limiter = TimeWindow::new(1000, 5);
for i in 0..5 {
    limiter.add_event(1000 + i * 10);
}
assert!(limiter.would_exceed_limit(1050, 5));

Implementations

impl TimeWindow

pub fn new(window_size_ms: u64, max_events: usize) -> Self

Create a new time window.

Arguments

• window_size_ms - Window size in milliseconds
• max_events - Maximum number of events to track

pub fn add_event(&mut self, timestamp_ms: i64)

Add an event at the current time.

pub fn count_events(&mut self, now_ms: i64) -> usize

Get the count of events within the window from the given timestamp.

pub fn would_exceed_limit(&mut self, now_ms: i64, limit: usize) -> bool

Check if adding a new event would exceed the given limit.

pub fn events_per_second(&mut self, now_ms: i64) -> f64

Get events per second rate.

pub fn clear(&mut self)

Clear all events.

pub fn oldest_event_age_ms(&self, now_ms: i64) -> Option<u64>

Get the age of the oldest event in milliseconds.

pub fn is_full(&self) -> bool

Check if the window is full.

Trait Implementations

impl Clone for TimeWindow

fn clone(&self) -> TimeWindow

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TimeWindow

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

Formats the value using the given formatter.