longname(3curses)

longname -- get verbose description of current terminal

Synopsis

cc [options] file -lcurses

#include <curses.h>

char *longname(void);

Description

The longname(3curses) function generates a verbose description of the current terminal. The maximum length of a verbose description is 128 bytes. It is defined only after the call to initscr(3curses) or newterm(3curses).

Return value

Upon successful completion, longname(3curses) returns a pointer to the description specified above. Otherwise, it returns a null pointer on error.

Errors

No errors are defined.

Usage

The return value of longname(3curses) may point to a static area which is overwritten by a subsequent call to newterm(3curses).

Standards Conformance

The Single UNIX Specification, Version 2; The Open Group.

References

initscr(3curses), curses(4)