---
name: "termkey_get_buffer_remaining"
section: "3"
platform: "linux"
package: "libtermkey-dev"
version: "0.22-2+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/termkey_get_buffer_remaining"
---

# termkey\_get\_buffer\_remaining(3)

returns the free buffer space

## NAME

termkey\_get\_buffer\_remaining - returns the free buffer space

## SYNOPSIS

```
#include <termkey.h>

size_t termkey_get_buffer_remaining(TermKey *tk);
```

Link with *-ltermkey*.

## DESCRIPTION

**termkey\_get\_buffer\_remaining**() returns the number of bytes of buffer space currently free in the [**termkey**(7)](/termkey/7.md) instance. These bytes are free to use by [**termkey\_push\_bytes**(3)](/termkey_push_bytes/3.md), or may be filled by [**termkey\_advisereadable**(3)](/termkey_advisereadable/3.md).

## RETURN VALUE

**termkey\_get\_buffer\_remaining**() returns a size in bytes.

## SEE ALSO

[**termkey\_push\_bytes**(3)](/termkey_push_bytes/3.md), [**termkey\_advisereadable**(3)](/termkey_advisereadable/3.md), [**termkey\_set\_buffer\_size**(3)](/termkey_set_buffer_size/3.md), **termkey\_get\_buffer\_size**(3), [**termkey\_getkey**(3)](/termkey_getkey/3.md), [**termkey**(7)](/termkey/7.md)