---
name: "unibi_add_ext_str"
section: "3"
platform: "linux"
package: "unibilium"
version: "2.1.4-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/unibi_add_ext_str"
---

# unibi\_add\_ext\_str(3)

add extended capabilities to a terminal object

## NAME

unibi\_add\_ext\_bool, unibi\_add\_ext\_num, unibi\_add\_ext\_str - add extended capabilities to a terminal object

## SYNOPSIS

```
 #include <unibilium.h>
 size_t unibi_add_ext_bool(unibi_term *ut, const char *t, int b);
 size_t unibi_add_ext_num(unibi_term *ut, const char *t, int v);
 size_t unibi_add_ext_str(unibi_term *ut, const char *t, const char *s);
```

## DESCRIPTION

Add an extended boolean, numeric, or string capability with the specified name and value.

Note that these functions simply store any pointers they are given. They will not free *t* or *s* or copy any strings.

## RETURN VALUE

The return value is the index of the new capability, which can be used in [**unibi\_get\_ext\_bool**(3)](/unibi_get_ext_bool/3.md), [**unibi\_set\_ext\_bool**(3)](/unibi_set_ext_bool/3.md), etc. If an error occurs, `"SIZE_MAX"` is returned.

## SEE ALSO

[**unibilium.h**(3)](/unibilium.h/3.md), [**unibi\_del\_ext\_bool**(3)](/unibi_del_ext_bool/3.md), **unibi\_del\_ext\_num**(3), **unibi\_del\_ext\_str**(3)