| TERMCAP(3) | Library Functions Manual | TERMCAP(3) | 
tgetent, tgetnum,
  tgetflag, tgetstr,
  tgoto —
#include <termcap.h>
char PC;
  
  char *BC;
  
  char *UP;
int
  
  tgetent(char
    *bp, const char
    *name);
int
  
  tgetnum(const
    char *id);
int
  
  tgetflag(const
    char *id);
char *
  
  tgetstr(const
    char *id, char
    **area);
char *
  
  tgoto(const
    char *cm, int
    destcol, int
    destline);
The tgetent() function calls
    setupterm() and configures PC,
    UP and BC. Only
    PC is actually used internally. The
    tgetent() function returns -1 if none of the
    terminfo data base files could be opened, 0 if the
    terminal name given does not match an entry, and 1 if all goes well. The
    bp argument is not used.
The tgetnum() function gets the numeric
    value of the capability id, returning -1 if it is not
    given for the terminal. The tgetflag() function
    returns 1 if the specified capability is present in the terminal's entry, 0
    if it is not. The tgetstr() function returns the
    string value of the capability id. This is a
    terminfo(5) string and not a
    termcap string; as such it should only be processed
    by tgoto(). The tgetstr()
    function returns NULL if the capability was not
    found. The area argument is unused.
The tgoto() function returns a cursor
    addressing string decoded from cm to go to column
    destcol in line destline, or
    NULL on error conditions such as out of memory.
    Please note that tgoto() can return an incomplete
    value on a malformed input sequence. Historically
    tgoto() used to return “OOPS” on those
    conditions, so newer programs should now be checking the return value.
termcap first appeared in 4.0BSD.
  NetBSD 1.5 introduced some
  termcap t_*() extensions which
  were removed in NetBSD 6.0 when
  terminfo(3) was introduced.
| March 14, 2011 | NetBSD 9.3 |