curs_termcap(3X)        LIBRARY FUNCTIONS        curs_termcap(3X)



NAME
     curstermcap:  tgetent, tgetflag, tgetnum,  tgetstr,  tgoto,
     tputs - curses interfaces (emulated) to the termcap library

SYNOPSIS
     #include <curses.h>
     #include <term.h>
     int tgetent(char *bp, char *name);
     int tgetflag(char id[2]);
     int tgetnum(char id[2]);
     char *tgetstr(char id[2], char **area);
     char *tgoto(char *cap, int col, int row);
     int tputs(char *str, int affcnt, int (*putc)(void));

DESCRIPTION
     These routines are included as a conversion aid for programs
     that use the termcap library.  Their parameters are the same
     and the routines are emulated using the  terminfo  database.
     These  routines  are  supported at Level 2 and should not be
     used in new applications.

     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.  Use tputs to output  the  returned
     string.   The tgoto routine instantiates the parameters into
     the given capability.  The output from this routine is to be
     passed  to  tputs.   The  tputs  routine is described on the
     curs_terminfo(4) manual page.

RETURN VALUE
     Routines that return an integer return ERR upon failure  and
     an  integer value other than ERR upon successful completion.
     Routines that return pointers return NULL on error.

NOTES
     The header file <curses.h> automatically includes the header
     files <stdio.h> and <unctrl.h>.

SEE ALSO
     curses(3X), cursterminfo(4), putc(3S).













                                                                1