longname Subroutine

Purpose

Returns the verbose name of a terminal.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>
char *longname(void);

Description

The longname subroutine generates a verbose description for the current terminal. The maximum length of a verbose description is 128 bytes. It is defined only after the call to the initscr or newterm subroutines.

The area is overwritten by each call to the newterm subroutine, so the value should be saved if you plan on using the longname subroutine with multiple terminals.

Return Values

Upon successful completion, the longname subroutine returns a pointer to the description specified above. Otherwise, it returns a null pointer on error.