longname(CURSES)

longname -- get verbose description of current terminal

Synopsis

cc [options] file -lcurses

#include <curses.h>

char *longname(void);

Description

The longname(CURSES) 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(CURSES) or newterm(CURSES).

Return value

Upon successful completion, longname(CURSES) 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(CURSES) may point to a static area which is overwritten by a subsequent call to newterm(CURSES).

Standards Conformance

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

References

initscr(CURSES), curses(F)