NAME

       tickit_ref, tickit_unref - adjust the refcount of the toplevel instance

SYNOPSIS

       #include <tickit.h>

       Tickit *tickit_ref(Tickit *t);
       void tickit_unref(Tickit *t);

       Link with -ltickit.

DESCRIPTION

       tickit_ref() increments the stored refcount of the given toplevel instance by one. It returns the pointer
       argument itself, so it is useful for chaining.

       tickit_unref() decrements the stored refcount of the given toplevel instance  by  one.  If  the  refcount
       drops to zero, the instance is destroyed. This will release any resources controlled by it and unbind all
       pending timer and later callbacks, causing  them  to  be  invoked  with  the  TICKIT_EV_DESTROY  flag  if
       appropriate.  This  will  also  decrement  refcount on the terminal and root window instances, which will
       likely cause them to be destroyed too.

RETURN VALUE

       tickit_ref() returns a toplevel instance pointer. tickit_unref() returns no value.

SEE ALSO

       tickit_new_stdio(3), tickit(7)

                                                                                                   TICKIT_REF(3)