1TICKIT_WATCH_LATER(3)      Library Functions Manual      TICKIT_WATCH_LATER(3)
2
3
4

NAME

6       tickit_watch_later - invoke a callback at the next round of IO events
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_later(Tickit *t, TickitBindFlags flags,
15           TickitCallbackFn *fn, void *user);
16
17       Link with -ltickit.
18

DESCRIPTION

20       tickit_watch_later() registers a callback function to be invoked by the
21       toplevel event loop as it processes the next round of IO events. A reg‐
22       istered  callback  will  be invoked by a running call to tickit_run(3).
23       The callback function will be invoked once, and then  destroyed  after‐
24       wards. The info pointer will be NULL.
25
26       When   invoked,   the   callback   function   is   always  passed  both
27       TICKIT_EV_FIRE and TICKIT_EV_UNBIND flags to its flags argument. If the
28       callback had been registered with the TICKIT_BIND_DESTROY flag, then it
29       will also be invoked with the TICKIT_EV_DESTROY flag if it has not  yet
30       been invoked by the time the toplevel instance is destroyed.
31
32       If registered with the TICKIT_BIND_FIRST flag, the callback will be in‐
33       serted at the start of the queue, coming before others. If not,  it  is
34       appended at the end.
35
36       If cancelled by tickit_watch_cancel(3) the callback function is invoked
37       with just the TICKIT_EV_UNBIND flag if  it  had  been  registered  with
38       TICKIT_BIND_UNBIND.
39

RETURN VALUE

41       tickit_watch_later() returns an opaque identifier pointer.
42

SEE ALSO

44       tickit_new_stdio(3),     tickit_watch_io(3),     tickit_watch_timer_af‐
45       ter_msec(3),  tickit_watch_timer_at_epoch(3),   tickit_watch_signal(3),
46       tickit_watch_process(3), tickit_watch_cancel(3), tickit(7)
47
48
49
50                                                         TICKIT_WATCH_LATER(3)
Impressum