1TICKIT_WATCH_TIMER_AT_EPOCH(L3i)brary Functions ManuTaIlCKIT_WATCH_TIMER_AT_EPOCH(3)
2
3
4

NAME

6       tickit_watch_timer_at_* - invoke a callback at a fixed future time
7

SYNOPSIS

9       #include <tickit.h>
10
11       typedef int TickitCallbackFn(Tickit *t, TickitEventflags flags,
12           void *info, void *user);
13
14       void *tickit_watch_timer_at_epoch(Tickit *t, time_t at,
15           TickitBindFlags flags, TickitCallbackFn *fn, void *user);
16       void *tickit_watch_timer_at_tv(Tickit *t, const struct timeval *at,
17           TickitBindFlags flags, TickitCallbackFn *fn, void *user);
18
19       Link with -ltickit.
20

DESCRIPTION

22       The  tickit_watch_timer_at_*()  family of functions register a callback
23       function to be invoked by the toplevel event loop at a  fixed  time  in
24       the  future. A registered callback will be invoked by a running call to
25       tickit_run(3). The callback function will be invoked once, and then de‐
26       stroyed afterwards. Each function returns an opaque pointer value which
27       serves to identify this instance. The info pointer will be NULL.
28
29       When  invoked,  the   callback   function   is   always   passed   both
30       TICKIT_EV_FIRE and TICKIT_EV_UNBIND flags to its flags argument. If the
31       callback had been registered with the TICKIT_BIND_DESTROY flag, then it
32       will  also be invoked with the TICKIT_EV_DESTROY flag if it has not yet
33       been invoked by the time the toplevel instance is destroyed.
34
35       If cancelled by tickit_watch_cancel(3) the callback function is invoked
36       with  just  the  TICKIT_EV_UNBIND  flag  if it had been registered with
37       TICKIT_BIND_UNBIND.
38

RETURN VALUE

40       tickit_watch_timer_at_epoch() and tickit_watch_timer_at_tv() return  an
41       opaque identifier pointer.
42

SEE ALSO

44       tickit_new_stdio(3),                  tickit_watch_timer_after_msec(3),
45       tickit_watch_later(3), tickit_watch_signal(3), tickit_watch_process(3),
46       tickit_watch_cancel(3), tickit(7)
47
48
49
50                                                TICKIT_WATCH_TIMER_AT_EPOCH(3)
Impressum