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

NAME

6       tickit_ctlname - return the name of a toplevel instance control
7

SYNOPSIS

9       #include <tickit.h>
10
11       const char * tickit_ctlname(TickitCtl ctl);
12       TickitCtl tickit_lookup_ctl(const char * name);
13
14       TickitType tickit_ctltype(TickitCtl ctl);
15
16       Link with -ltickit.
17

DESCRIPTION

19       tickit_ctlname()  returns  the name of the given toplevel instance con‐
20       trol. These names are the lowercase strings given in tickit(7).
21
22       tickit_lookup_ctl() returns the control constant for a given  name.  If
23       the name is not recognised then -1 is returned.
24
25       tickit_ctltype() returns the type of the given instance control, as one
26       of the following constants:
27
28       TICKIT_TYPE_BOOL
29              The value is an integer representing a  simple  boolean  choice,
30              where  any  nonzero  value is true. Use tickit_setctl_int(3) and
31              tickit_getctl_int(3).
32
33       TICKIT_TYPE_INT
34              The value is an integer representing a quantity, or a  value  in
35              some   particular   enumeration.  Use  tickit_setctl_int(3)  and
36              tickit_getctl_int(3).
37
38       For unrecognised control types, the function returns 0.
39

RETURN VALUE

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

SEE ALSO

46       tickit(7)
47
48
49
50                                                             TICKIT_CTLNAME(3)