tickit_ctl_name - Man Page
return the name of a toplevel instance control
Synopsis
#include <tickit.h> const char * tickit_ctl_name(TickitCtl ctl); TickitCtl tickit_ctl_lookup(const char * name); TickitType tickit_ctl_type(TickitCtl ctl);
Link with -ltickit.
Description
tickit_ctl_name() returns the name of the given toplevel instance control. These names are the lowercase strings given in tickit(7).
tickit_ctl_lookup() returns the control constant for a given name. If the name is not recognised then -1 is returned.
tickit_ctl_type() returns the type of the given instance control, as one of the following constants:
- TICKIT_TYPE_BOOL
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).
- TICKIT_TYPE_INT
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_ctl_name() returns a constant string pointer. tickit_ctl_lookup() returns an control constant or -1. tickit_ctl_type() returns a control type constant or 0.
See Also
Referenced By
The man pages tickit_ctl_lookup(3) and tickit_ctl_type(3) are aliases of tickit_ctl_name(3).