Module: DiscreteEvent::Events

Defined in:
lib/discrete_event/events.rb

Overview

Mix-in for simulations with multiple objects that have to share the same clock. See the README for an example.

The implementing class must have an instance method event_queue that returns the EventQueue to use; this method may be private.

Instance Method Summary collapse

Instance Method Details

#after(delay) { ... } ⇒ nil

See DiscreteEvent::EventQueue#after.

Parameters:

  • delay (Number) —

    after which action should run; non-negative

Yields:

  • action to be run after delay

Returns:

  • (nil) 

32
33
34
 
# File 'lib/discrete_event/events.rb', line 32

def after delay, &action
  event_queue.after(delay, &action)
end

#at(time) { ... } ⇒ nil

See DiscreteEvent::EventQueue#at.

Parameters:

  • time (Number) —

    at which action should run; must be >= #now

Yields:

  • action to be run at time

Returns:

  • (nil) 

19
20
21
 
# File 'lib/discrete_event/events.rb', line 19

def at time, &action
  event_queue.at(time, &action)
end

#at_each(elements, time = nil) {|element| ... } ⇒ nil

See DiscreteEvent::EventQueue#at_each.

Parameters:

  • elements (Enumerable) —

    to yield; must be in ascending order according to time; note that this method keeps a reference to this object and removes elements as they are executed, so you may want to pass a copy if you plan to change it after this call returns

  • time (Proc, Symbol, nil) (defaults to: nil) —

    used to determine when the action will run for a given element; if a Proc, the proc must return the appropriate time; if a Symbol, each element must respond to time; if nil, it is assumed that element.time returns the time

Yields:

  • (element)

Yield Parameters:

  • element (Object) —

    from elements

Returns:

  • (nil) 

57
58
59
 
# File 'lib/discrete_event/events.rb', line 57

def at_each elements, time=nil, &action
  event_queue.at_each(elements, time, &action)
end

#every(interval, start = 0, &action) ⇒ nil

See DiscreteEvent::EventQueue#every.

Parameters:

  • interval (Numeric) —

    non-negative

  • start (Numeric) (defaults to: 0) —

    block first runs at this time

Returns:

  • (nil) 

80
81
82
 
# File 'lib/discrete_event/events.rb', line 80

def every interval, start=0, &action
  event_queue.every(interval, start, &action)
end

#now ⇒ Number

See DiscreteEvent::EventQueue#now.

Returns:

  • (Number) 

89
90
91
 
# File 'lib/discrete_event/events.rb', line 89

def now
  event_queue.now
end

#recur_after(interval) ⇒ nil

See DiscreteEvent::EventQueue#recur_after.

Parameters:

  • interval (Number) —

    non-negative

Returns:

  • (nil) 

68
69
70
 
# File 'lib/discrete_event/events.rb', line 68

def recur_after interval
  event_queue.recur_after(interval)
end