summaryrefslogtreecommitdiff
path: root/src/common/timer.hpp
blob: fdda344d1f5c851b32ce9d6107a2737158bfcd89 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
#ifndef TIMER_HPP
#define TIMER_HPP

# include "sanity.hpp"

enum TIMER_TYPE
{
    TIMER_NONE,
    TIMER_ONCE_AUTODEL,
    TIMER_INTERVAL,
};
/// This is needed to produce a signed result when 2 ticks are subtracted
# define DIFF_TICK(a,b) ((int32_t)((a)-(b)))

// TODO replace with signed 64-bit to make code more clear and protect from the future
typedef uint32_t tick_t;
typedef uint32_t interval_t;
typedef uint32_t timer_id;
// BUG: pointers are stored in here
typedef int32_t custom_id_t;
typedef int32_t custom_data_t;
typedef void (*timer_func) (timer_id, tick_t, custom_id_t, custom_data_t);

struct TimerData
{
    /// When it will be triggered
    tick_t tick;
    /// What will be done
    timer_func func;
    /// Arbitrary data. WARNING, callers are stupid and put pointers in here
    // Should we change to void* or intptr_t ?
    custom_id_t  id;
    custom_data_t  data;
    /// Type of timer - 0 initially
    enum TIMER_TYPE type;
    /// Repeat rate
    interval_t interval;
};

/// Server time, in milliseconds, since the epoch,
/// but use of 32-bit integers means it wraps every 49 days.
// The only external caller of this function is the core.c main loop, but that makes sense
// in fact, it might make more sense if gettick() ALWAYS returned that cached value
tick_t gettick_nocache (void);
/// This function is called enough that it's worth caching the result for
/// the next 255 times
tick_t gettick (void);

timer_id add_timer (tick_t, timer_func, custom_id_t, custom_data_t);
timer_id add_timer_interval (tick_t, timer_func, custom_id_t, custom_data_t, interval_t);
void delete_timer (timer_id, timer_func);

tick_t addtick_timer (timer_id, interval_t);
struct TimerData *get_timer (timer_id tid);

/// Do all timers scheduled before tick, and return the number of milliseconds until the next timer happens
interval_t do_timer (tick_t tick);



#endif // TIMER_HPP