---
name: "tickit_termctl_name"
section: "3"
platform: "linux"
package: "libtickit-dev"
version: "0.4.3-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/tickit_termctl_name"
---

# tickit\_termctl\_name(3)

return the name of a terminal control

## NAME

tickit\_termctl\_name - return the name of a terminal control

## SYNOPSIS

```
#include <tickit.h>

const char * tickit_termctl_name(TickitTermCtl ctl);
TickitTermCtl tickit_termctl_lookup(const char * name);

TickitType tickit_termctl_type(TickitTermCtl ctl);
```

Link with *-ltickit*.

## DESCRIPTION

**tickit\_termctl\_name**() returns the name of the given terminal control. These names are the lowercase strings given in [**tickit\_term**(7)](/tickit_term/7.md).

**tickit\_termctl\_lookup**() returns the control constant for a given name. If the name is not recognised then -1 is returned.

**tickit\_termctl\_type**() returns the type of the given terminal 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\_term\_setctl\_int**(3)](/tickit_term_setctl_int/3.md) and [**tickit\_term\_getctl\_int**(3)](/tickit_term_getctl_int/3.md).

- **TICKIT\_TYPE\_INT**

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

- **TICKIT\_TYPE\_STR**

  The value is a string. Use [**tickit\_term\_setctl\_str**(3)](/tickit_term_setctl_str/3.md).

For unrecognised control types, the function returns 0.

## RETURN VALUE

**tickit\_termctl\_name**() returns a constant string pointer. **tickit\_termctl\_lookup**() returns an control constant or -1. **tickit\_termctl\_type**() returns a control type constant or 0.

## SEE ALSO

[**tickit\_term**(7)](/tickit_term/7.md), [**tickit**(7)](/tickit/7.md)