---
name: "termkey_get_keyname"
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_keyname"
---

# termkey\_get\_keyname(3)

return a string name for a symbolic key

## NAME

termkey\_get\_keyname - return a string name for a symbolic key

## SYNOPSIS

```
#include <termkey.h>

const char *termkey_get_keyname(TermKey *tk, TermKeySym sym);
```

Link with *-ltermkey*.

## DESCRIPTION

**termkey\_get\_keyname**() returns a human-readable string name for the symbolic key value given by *sym*. The returned string is owned by the [**termkey**(7)](/termkey/7.md) instance *tk* so should not be modified or freed. The returned pointer is guaranteed to be valid until the instance is released using **termkey\_destroy**(3). This function is the inverse of [**termkey\_keyname2sym**(3)](/termkey_keyname2sym/3.md).

## RETURN VALUE

**termkey\_get\_key**() returns a pointer to a string.

## SEE ALSO

[**termkey\_lookup\_keyname**(3)](/termkey_lookup_keyname/3.md), [**termkey\_keyname2sym**(3)](/termkey_keyname2sym/3.md), [**termkey\_strfkey**(3)](/termkey_strfkey/3.md), [**termkey**(7)](/termkey/7.md)