Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
TICKIT_REF(3)		   Library Functions Manual		 TICKIT_REF(3)

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 in-
       stance by one. It returns the pointer argument itself, so it is	useful
       for chaining.

       tickit_unref() decrements the stored refcount of	the given toplevel in-
       stance  by  one.	 If  the  refcount  drops to zero, the instance	is de-
       stroyed.	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 re-
       fcount 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() re-
       turns no	value.

SEE ALSO
       tickit_new_stdio(3), tickit(7)

								 TICKIT_REF(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=tickit_ref&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help