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

# tickit\_term\_setctl\_str(3)

set an integer or string terminal control

## NAME

tickit\_term\_setctl\_int, tickit\_term\_setctl\_str - set an integer or string terminal control

## SYNOPSIS

```
#include <tickit.h>

bool tickit_term_getctl_int(TickitTerm *tt, TickitTermCtl ctl, int *value);
bool tickit_term_setctl_int(TickitTerm *tt, TickitTermCtl ctl, int value);
bool tickit_term_setctl_str(TickitTerm *tt, TickitTermCtl ctl, const char *value);
```

Link with *-ltickit*.

## DESCRIPTION

**tickit\_term\_setctl\_int**() performs a terminal control operation, setting the value of a numeric terminal control option. **tickit\_term\_setctl\_str**() sets the value of a string terminal control option. **tickit\_term\_getctl\_int**() obtains the value of a terminal control setting.

For the list of possible **TickitTermCtl** values and their meanings, see [**tickit\_term**(7)](/tickit_term/7.md).

## RETURN VALUE

**tickit\_term\_getctl\_int**() returns a true value if it recognised the requested control and managed to return the current value of it; false if not. **tickit\_term\_setctl\_int**() and **tickit\_term\_setctl\_str**() return a true value if it recognised the requested control and managed to request the terminal to change it; false if not.

## SEE ALSO

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