---
name: "extensions"
section: "3ncurses"
platform: "linux"
package: "ncurses-doc"
version: "6.5+20250216-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/extensions"
---

# extensions(3ncurses)

miscellaneous curses extensions

## NAME

**curses\_version**, **use\_extended\_names** - miscellaneous *curses* extensions

## SYNOPSIS

```
#include <curses.h>
```

**const char \* curses\_version(void);** **int use\_extended\_names(bool** *bf***);**

## DESCRIPTION

**These** *ncurses* **extensions to the** *curses* **library do not fit easily into other functional categories.**

### curses\_version

**curses\_version** **returns a pointer to a string containing the library's name** **and version number,** **including its patch level,** **for example** **“ncurses 6.5.20240720”.**

### use\_extended\_names

**use\_extended\_names** **configures whether the library recognizes** **user-defined or nonstandard** *terminfo* **capability names that may be compiled into terminal type descriptions** **via the terminfo(3NCURSES) or termcap(3NCURSES) interfaces.** **Normally these names are available for use,** **since the essential decision** **is made through use of [tic(1)](/tic/1.md)'s** **-x** **option to include such extensions in terminal type descriptions.** **use\_extended\_names** **can prevent** *ncurses* **from recognizing these capabilities** **to ensure compatibility with other implementations of** *curses*.

## RETURN VALUE

**curses\_version** **returns a constant string.**

**use\_extended\_names** **returns the previous state of extended capability name recognition,** **allowing you to save this property and restore it.**

## NOTES

**The pointer returned by** **curses\_version** **corresponds to statically allocated memory;** **do not attempt to** *free***(3) it.**

## EXTENSIONS

**These functions are** *ncurses* **extensions,** **and are not found in SVr4** *curses*, **4.4BSD** *curses*, **or any other previous** *curses* **implementation.**

## PORTABILITY

**Applications employing** *ncurses* **extensions should condition their use on the visibility of the** **NCURSES\_VERSION** **preprocessor macro.**

## AUTHORS

**Thomas Dickey**

## SEE ALSO

*ncurses* **offers several other extensions to the X/Open Curses API.**

**getch(3NCURSES),** **inopts(3NCURSES),** **mouse(3NCURSES),** **print(3NCURSES),** **util(3NCURSES),** **default\_colors(3NCURSES),** **define\_key(3NCURSES),** **keybound(3NCURSES),** **keyok(3NCURSES),** **new\_pair(3NCURSES),** **resizeterm(3NCURSES),** **wresize(3NCURSES)**