Technical Reference: Base Operating System and Extensions, Volume 2

tgetstr Subroutine

Purpose

Returns the string entry for the specified termcap identifier.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>

char *tgetstr( ID, Area) char *ID, **Area;

Description

The tgetstr subroutine returns the string entry for the specified termcap identifier. This subroutine is provided for binary compatibility with applications that use the termcap file.

Parameters

Area	Contains the string entry for the specified termcap identifier. This also is returned to the calling program.
ID	Specifies the 2-character string that contains the termcap identifier.

Return Values

The tgetstr subroutine returns the string entry for the ID parameter, which is a 2-character string that contains a termcap identifier.

0	Returned if ID is not found or not a string capability.

Related Information

Curses Overview for Programming in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.

List of Curses Subroutines in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.

Understanding Terminals with Curses in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.