tickit_ctlname - Man Page

return the name of a toplevel instance control


#include <tickit.h>

const char * tickit_ctlname(TickitCtl ctl);
TickitCtl tickit_lookup_ctl(const char * name);

TickitType tickit_ctltype(TickitCtl ctl);

Link with -ltickit.


tickit_ctlname() returns the name of the given toplevel instance control. These names are the lowercase strings given in tickit(7).

tickit_lookup_ctl() returns the control constant for a given name. If the name is not recognised then -1 is returned.

tickit_ctltype() returns the type of the given instance control, as one of the following constants:


The value is an integer representing a simple boolean choice, where any nonzero value is true. Use tickit_setctl_int(3) and tickit_getctl_int(3).


The value is an integer representing a quantity, or a value in some particular enumeration. Use tickit_setctl_int(3) and tickit_getctl_int(3).

For unrecognised control types, the function returns 0.

Return Value

tickit_ctlname() returns a constant string pointer. tickit_lookup_ctl() returns an control constant or -1. tickit_ctltype() returns a control type constant or 0.

See Also


Referenced By


The man pages tickit_ctltype(3) and tickit_lookup_ctl(3) are aliases of tickit_ctlname(3).