[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions, Volume 2

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.

Related Information

The initscr (initscr and newterm Subroutine) subroutine, newterm (newterm Subroutine) subroutine, setupterm (setupterm Subroutine) subroutine.

Curses Overview for Programming, List of Curses Subroutines, Understanding Terminals with Curses in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]