LONGNAME(3XCURSES) X/Open Curses Library Functions LONGNAME(3XCURSES)
NAME
longname - return full terminal type name
SYNOPSIS
cc [
flag... ]
file...
-I /usr/xpg4/include
-L /usr/xpg4/lib \
-R /usr/xpg4/lib
-lcurses [
library... ]
c89 [
flag... ]
file...
-lcurses [
library... ]
#include <curses.h>
const char *longname(
void);
DESCRIPTION
The
longname() function returns a pointer to a static area containing
a verbose description (128 characters or fewer) of the terminal. The
area is defined after calls to
initscr(3XCURSES),
newterm(3XCURSES),
or
setupterm(3XCURSES). The value should be saved if
longname() is
going to be used with multiple terminals since it will be
overwritten with a new value after each call to
newterm() or
setupterm().
RETURN VALUES
On success, the
longname() function returns a pointer to a verbose
description of the terminal. Otherwise, it returns a null pointer.
ERRORS
None.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | Unsafe |
+--------------------+-----------------+
SEE ALSO
initscr(3XCURSES),
libcurses(3XCURSES),
newterm(3XCURSES),
setupterm(3XCURSES),
attributes(7),
standards(7) June 5, 2002 LONGNAME(3XCURSES)
