


curs_termcap(3X)                                 curs_termcap(3X)


NNAAMMEE
       ccuurrss__tteerrmmccaapp:  ttggeetteenntt, ttggeettffllaagg, ttggeettnnuumm, ttggeettssttrr, ttggoottoo,
       ttppuuttss - direct ccuurrsseess interface to the terminfo capability
       database

SSYYNNOOPPSSIISS
       ##iinncclluuddee <<ccuurrsseess..hh>>
       ##iinncclluuddee <<tteerrmm..hh>>
       iinntt ttggeetteenntt((cchhaarr **bbpp,, cchhaarr **nnaammee));;
       iinntt ttggeettffllaagg((cchhaarr** iidd));;
       iinntt ttggeettnnuumm((cchhaarr** iidd));;
       cchhaarr **ttggeettssttrr((cchhaarr** iidd,, cchhaarr ****aarreeaa));;
       cchhaarr **ttggoottoo((cchhaarr **ccaapp,, iinntt ccooll,, iinntt rrooww));;
       iinntt ttppuuttss((cchhaarr **ssttrr,, iinntt aaffffccnntt,, iinntt ((**ppuuttcc))((vvooiidd))));;

DDEESSCCRRIIPPTTIIOONN
       These  routines  are included as a conversion aid for pro-
       grams that use the _t_e_r_m_c_a_p library.  Their parameters  are
       the  same and the routines are emulated using the _t_e_r_m_i_n_f_o
       database.  Thus, they can only be used to query the  capa-
       bilities  of  entries  for which a terminfo entry has been
       compiled.

       The ttggeetteenntt routine loads the entry for _n_a_m_e.  The  emula-
       tion ignores the buffer pointer _b_p.

       The ttggeettffllaagg routine gets the boolean entry for _i_d.

       The ttggeettnnuumm routine gets the numeric entry for _i_d.

       The  ttggeettssttrr routine returns the string entry for _i_d.  Use
       ttppuuttss to output the returned string.

       The ttggoottoo routine instantiates  the  parameters  into  the
       given  capability.   The output from this routine is to be
       passed to ttppuuttss.

       The ttppuuttss routine is  described  on  the  curs_tteerrmmiinnffoo(5)
       manual page.

RREETTUURRNN VVAALLUUEE
       Routines  that  return  an integer return EERRRR upon failure
       and OOKK (SVr4 only specifies "an integer value  other  than
       EERRRR") upon successful completion.

       Routines that return pointers return NNUULLLL on error.

BBUUGGSS
       If you call ttggeettssttrr to fetch ccaa or any other parameterized
       string, be aware that it  will  be  returned  in  terminfo
       notation,  not  the older and not-quite-compatible termcap
       notation.  This won't cause problems if all you do with it
       is  call ttggoottoo or ttppaarrmm, which both expand terminfo-style.




                                                                1





curs_termcap(3X)                                 curs_termcap(3X)


PPOORRTTAABBIILLIITTYY
       The XSI Curses standard, Issue  4  describes  these  func-
       tions.   However,  they are marked TO BE WITHDRAWN and may
       be removed in future versions.

SSEEEE AALLSSOO
       ccuurrsseess(3X), ccuurrss__tteerrmmiinnffoo((55)),, ppuuttcc((33SS))..


















































                                                                2


