Content-type: text/html
curs_termcap, tgetent, tgetflag, tgetnum, tgetstr, tgoto - Curses interfaces that support termcap capabilities
#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
);
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.
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.
The header file
<curses.h>
automatically
includes the header file
<stdio.h>.
Routines that return an integer return ERR upon failure and OK upon successful completion.
Routines that return pointers return
NULL
on error.
Functions: curses(3), curs_terminfo(3), putc(3)
Others: standards(5)