1TICKIT_PEN_REF(3)          Library Functions Manual          TICKIT_PEN_REF(3)
2
3
4

NAME

6       tickit_pen_ref, tickit_pen_unref - adjust the refcount of a pen
7

SYNOPSIS

9       #include <tickit.h>
10
11       TickitPen *tickit_pen_ref(TickitPen *pen);
12       void tickit_pen_unref(TickitPen *pen);
13
14       Link with -ltickit.
15

DESCRIPTION

17       tickit_pen_ref()  increments  the  stored  refcount  of  the  given pen
18       instance by one. It returns the pointer argument itself, so it is  use‐
19       ful for chaining.
20
21       tickit_pen_unref()  decrements  the  stored  refcount  of the given pen
22       instance by one. If  the  refcount  drops  to  zero,  the  instance  is
23       destroyed.  This will release any resources controlled by it and unbind
24       all the bound event handlers, causing handlers to be invoked  with  the
25       TICKIT_EV_DESTROY flag if appropriate.
26

RETURN VALUE

28       tickit_pen_ref()  returns  a  pen  instance pointer. tickit_pen_unref()
29       returns no value.
30

SEE ALSO

32       tickit_pen_new(3), tickit_pen(7), tickit(7)
33
34
35
36                                                             TICKIT_PEN_REF(3)
Impressum