HP 3000 Manuals

MPE/iX Developer's Kit Reference Manual Volume II

tgetstr 

The tgetstr routine is used to get the string entry for termcap
capability (interface to termcap library).

Syntax 

     #include <curses.h>

     char *tgetstr (char cap[2], char **area);

Parameters 

cap                   The termcap capability for which to get the string
                      entry.

area                  A pointer to the area where the decoded string is
                      stored.

Return Values 

On success, a pointer to the string is returned; otherwise, a null
pointer is returned.

Description 

The tgetstr() routine looks up the string entry for the termcap cap,
placing the decoded string at area and advancing the area pointers.  The
tputs() routine should be used to output the string.

The tgetstr() routine is included for compatibility purposes with
programs that use the termcap library.  New programs should use the
terminfo routines.

Implementation Considerations 

UNIX System V implementations

See Also 

tigetstr(), tputs(), tparm()

Portability 

HP-UX, UNIX System V

MPE/iX 5.0 Documentation