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_timer_at_epoch(Tickit *t, time_t at,
15           TickitBindFlags flags, TickitCallbackFn *fn, void *user);
16       void *tickit_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
26       destroyed  afterwards.  Each  function  returns an opaque pointer value
27       which 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

RETURN VALUE

36       tickit_timer_at_epoch() and tickit_timer_at_tv() return an opaque iden‐
37       tifier pointer.
38

SEE ALSO

40       tickit_new_stdio(3),                  tickit_watch_timer_after_msec(3),
41       tickit_watch_later(3), tickit_watch_cancel(3), tickit(7)
42
43
44
45                                                TICKIT_WATCH_TIMER_AT_EPOCH(3)
Impressum