---
name: "tickit_ctltype"
section: "3"
platform: "linux"
package: "libtickit-dev"
version: "0.4.1-1"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/tickit_ctltype"
---

# tickit\_ctltype(3)

return the name of a toplevel instance control

## NAME

tickit\_ctlname - return the name of a toplevel instance control

## SYNOPSIS

```
#include <tickit.h>

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

TickitType tickit_ctltype(TickitCtl ctl);
```

Link with *-ltickit*.

## DESCRIPTION

**tickit\_ctlname**() returns the name of the given toplevel instance control. These names are the lowercase strings given in [**tickit**(7)](/tickit/7.md).

**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:

- **TICKIT\_TYPE\_BOOL**

  The value is an integer representing a simple boolean choice, where any nonzero value is true. Use [**tickit\_setctl\_int**(3)](/tickit_setctl_int/3.md) and [**tickit\_getctl\_int**(3)](/tickit_getctl_int/3.md).

- **TICKIT\_TYPE\_INT**

  The value is an integer representing a quantity, or a value in some particular enumeration. Use [**tickit\_setctl\_int**(3)](/tickit_setctl_int/3.md) and [**tickit\_getctl\_int**(3)](/tickit_getctl_int/3.md).

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

[**tickit**(7)](/tickit/7.md)