Index Click this button to go to the index for this section.


curs_termcap(3)

NAME

curs_termcap, tgetent, tgetflag, tgetnum, tgetstr, tgoto - Curses interfaces that support termcap capabilities

LIBRARY

Curses Library (libcurses.a, libcurses.so)

SYNOPSIS

#include <term.h> int tgetent(char *bp, const char *name); int tgetflag(char id[2]); int tgetnum(char id[2]); char *tgetstr(char id[2], char **area); char *tgoto(const char *cap, int col, int row);

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows: tgetent, tgetflag, tgetnum, tgetstr, tgoto: XPG4-UNIX Refer to the standards(5) reference page for more information about industry standards and associated tags.

DESCRIPTION

These routines are obsolete and should not be used in new applications. The routines are included in the Curses library as a conversion aid for applications originally designed to use the termcap file. The routines include the same parameters as used with the termcap file but their operations are emulated by using the terminfo database. The tgetent routine looks up the termcap entry for name. The emulation ignores the buffer pointer bp. The tgetflag routine gets the Boolean entry for id. The tgetnum routine gets the numeric entry for id. The tgetstr routine returns the string entry for id. Applications use the tputs routine to output the returned string. The tgoto routine instantiates the parameters into the given capability. Applications pass output from this routine to the tputs routine. The tputs routine is described in the curs_terminfo(3) reference page.

NOTES

The header file curses.h automatically includes the header file stdio.h.

RETURN VALUES

Routines that return an integer return ERR upon failure and OK upon successful completion. Routines that return pointers return NULL on error.

RELATED INFORMATION

Functions: curses(3), curs_terminfo(3), putc(3) Others: standards(5)