man pages section 3: 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 Committed MT-Level Unsafe Standard See standards(7).

See Also

initscr(3XCURSES), libcurses(3XCURSES), newterm(3XCURSES), setupterm(3XCURSES), attributes(7), standards(7)