Man page - tickit_watch_later(3)

Packages contains this manual

Manual

TICKIT_WATCH_LATER

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
SEE ALSO

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 , 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.

If registered with the TICKIT_BIND_FIRST flag, the callback will be inserted at the start of the queue, coming before others. If not, it is appended at the end.

If cancelled by tickit_watch_cancel (3) the callback function is invoked with just the TICKIT_EV_UNBIND flag if it had been registered with TICKIT_BIND_UNBIND .

RETURN VALUE

tickit_watch_later () returns an opaque identifier pointer.

SEE ALSO

tickit_new_stdio (3), tickit_watch_io (3), tickit_watch_timer_after_msec (3), tickit_watch_timer_at_epoch (3), tickit_watch_signal (3), tickit_watch_process (3), tickit_watch_cancel (3), tickit (7)