tickit_pen_ref - Man Page
adjust the refcount of a pen
Synopsis
#include <tickit.h> TickitPen *tickit_pen_ref(TickitPen *pen); void tickit_pen_unref(TickitPen *pen);
Link with -ltickit.
Description
tickit_pen_ref() increments the stored refcount of the given pen instance by one. It returns the pointer argument itself, so it is useful for chaining.
tickit_pen_unref() decrements the stored refcount of the given pen 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.
Return Value
tickit_pen_ref() returns a pen instance pointer. tickit_pen_unref() returns no value.
See Also
Referenced By
tickit_pen(7), tickit_pen_new(3).
The man page tickit_pen_unref(3) is an alias of tickit_pen_ref(3).