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.  Otherwise, 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(), <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. 

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996