*** UNIX MANUAL PAGE BROWSER ***

curs_termcap(3) Library Functions Manual curs_termcap(3) NAME curs_termcap, tgetent, tgetflag, tgetnum, tgetstr, tgoto - Curses in- terfaces 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 stan- dards as follows: tgetent, tgetflag, tgetnum, tgetstr, tgoto: XPG4-UNIX Refer to the standards(5) reference page for more information about in- dustry 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 op- erations 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 capabil- ity. 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) delim off curs_termcap(3)