[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
Base Operating System and Extensions Technical Reference, 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.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The initscr subroutine, newterm subroutine, setupterm subroutine.

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


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]