longname.3x (2010 09)

l
longname(3X) longname(3X)
(CURSES)
NAME
longname — get verbose description of current terminal
SYNOPSIS
#include <curses.h>
char *longname(void);
DESCRIPTION
The longname() 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() or
newterm().
RETURN VALUE
Upon successful completion,
longname() returns a pointer to the description specified above. Other-
wise, it returns a null pointer on error.
ERRORS
No errors are defined.
APPLICATION USAGE
The return value of
longname() may point to a static area which is overwritten by a subsequent call to
newterm().
SEE ALSO
initscr(3X), <curses.h>.
CHANGE HISTORY
First released in X/Open Curses, Issue 2.
X/Open Curses, Issue 4
The entry is rewritten for clarity. The argument list for the
longname() function is explicitly declared
as void.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1