LeoNerd.org.uk

TICKIT_WATCH_LATER (3)

NAME

tickit_watch_later - invoke a callback at the next round of IO events

SYNOPSIS

#include <tickit.h> 
typedef int TickitCallbackFn(Tickit *t, TickitEventflags flags,
    void *info, void *user); 
void *tickit_watch_later(Tickit *t, int msec, TickitBindFlags flags,
    TickitCallbackFn *fn, void *user);
 

Link with -ltickit.

DESCRIPTION

tickit_watch_later() registers a callback function to be invoked by the toplevel event loop as it processes the next round of IO events. A registered callback will be invoked by a running call to tickit_run(3). The callback function will be invoked once, and then destroyed afterwards. The info pointer will be NULL.

When invoked, the callback function is always passed both TICKIT_EV_FIRE and TICKIT_EV_UNBIND flags to its flags argument. If the callback had been registered with the TICKIT_BIND_DESTROY flag, then it will also be invoked with the TICKIT_EV_DESTROY flag if it has not yet been invoked by the time the toplevel instance is destroyed.

RETURN VALUE

tickit_watch_later() returns an opaque identifier pointer.

SEE ALSO

tickit_new_stdio(3), tickit_watch_timer_after_msec(3), tickit_watch_timer_at_epoch(3), tickit_watch_cancel(3), tickit(7)