NAME

       tickit_term_ref, tickit_term_unref - adjust the refcount of a terminal

SYNOPSIS

       #include <tickit.h>

       TickitTerm *tickit_term_ref(TickitTerm *tt);
       void tickit_term_unref(TickitTerm *tt);

       Link with -ltickit.

DESCRIPTION

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

       tickit_term_unref() decrements the stored refcount of the given terminal instance by one. If the refcount
       drops to zero, the instance is destroyed. This will release any resources controlled by it and unbind all
       the bound event handlers, causing handlers to be invoked with the TICKIT_EV_DESTROY flag if  appropriate.
       It will not close any filehandles associated with the instance.

RETURN VALUE

       tickit_term_ref() returns a terminal instance pointer. tickit_term_unref() returns no value.

SEE ALSO

       tickit_term_build(3), tickit_term(7), tickit(7)

                                                                                              TICKIT_TERM_REF(3)