Curses Library Functions                    curstermcap(3CURSES)



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

SYNOPSIS
     cc [ flag ... ] file ... -lcurses [ library ... ]
     #include 
     #include 

     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().



SunOS 5.11          Last change: 31 Dec 1996                    1






Curses Library Functions                    curstermcap(3CURSES)



     The    tputs()    routine    is     described     on     the
     cursterminfo(3CURSES) manual page.

RETURN VALUES
     Routines that return an integer return ER upon failure  and
     an integer value other than ER upon successful completion.


     Routines that return pointers return NUL on error.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     cursterminfo(3CURSES),  curses(3CURSES),  putc(3C),  attri-
     butes(5)

NOTES
     The header   automatically  includes  the  headers
      and .

























SunOS 5.11          Last change: 31 Dec 1996                    2