tgetstr Subroutine

AIX Version 4.3 Base Operating System and Extensions Technical Reference, 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.

Implementation Specifics

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

Related Information

Curses Overview for Programming in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

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

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