home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / gnu / man / cat3 / termcap.0 < prev    next >
Text File  |  1993-12-07  |  6KB  |  133 lines
  1.  
  2. TERMCAP(3)                 UNIX Programmer's Manual                 TERMCAP(3)
  3.  
  4. NNAAMMEE
  5.      ttggeetteenntt, ttggeettnnuumm, ttggeettffllaagg, ttggeettssttrr, ttggoottoo, ttppuuttss - terminal independent
  6.      operation routines
  7.  
  8. SSYYNNOOPPSSIISS
  9.      _c_h_a_r _P_C_;
  10.      _c_h_a_r _*_B_C_;
  11.      _c_h_a_r _*_U_P_;
  12.      _s_h_o_r_t _o_s_p_e_e_d_;
  13.  
  14.      ttggeetteenntt(_c_h_a_r _*_b_p, _c_h_a_r _*_n_a_m_e)
  15.  
  16.      ttggeettnnuumm(_c_h_a_r _*_i_d)
  17.  
  18.      ttggeettffllaagg(_c_h_a_r _*_i_d)
  19.  
  20.      _c_h_a_r _*
  21.      ttggeettssttrr(_c_h_a_r _*_i_d, _c_h_a_r _*_a_r_e_a)
  22.  
  23.      _c_h_a_r _*
  24.      ttggoottoo(_c_h_a_r _*_c_m, _d_e_s_t_c_o_l, _d_e_s_t_l_i_n_e)
  25.  
  26.      ttppuuttss(_r_e_g_i_s_t_e_r _c_h_a_r _*_c_p, _i_n_t _a_f_f_c_n_t, _i_n_t _(_*_o_u_t_c_)_(_))
  27.  
  28. DDEESSCCRRIIPPTTIIOONN
  29.      These functions extract and use capabilities from a terminal capability
  30.      data base, usually _/_u_s_r_/_s_h_a_r_e_/_m_i_s_c_/_t_e_r_m_c_a_p, the format of which is de­
  31.      scribed in termcap(5).  These are low level routines; see curses(3) for a
  32.      higher level package.
  33.  
  34.      The ttggeetteenntt() function extracts the entry for terminal _n_a_m_e into the
  35.      buffer at _b_p. The _b_p argument should be a character buffer of size 1024
  36.      and must be retained through all subsequent calls to ttggeettnnuumm(),
  37.      ttggeettffllaagg(), and ttggeettssttrr().  The ttggeetteenntt() function returns -1 if none of
  38.      the tteerrmmccaapp data base files could be opened, 0 if the terminal name given
  39.      does not have an entry, and 1 if all goes well.  It will look in the en­
  40.      vironment for a TERMCAP variable.  If found, and the value does not begin
  41.      with a slash, and the terminal type _n_a_m_e is the same as the environment
  42.      string TERM, the TERMCAP string is used instead of reading a tteerrmmccaapp
  43.      file.  If it does begin with a slash, the string is used as a path name
  44.      of the tteerrmmccaapp file to search.  If TERMCAP does not begin with a slash
  45.      and _n_a_m_e is different from TERM, ttggeetteenntt() searches the files
  46.      _$_H_O_M_E_/_._t_e_r_m_c_a_p and _/_u_s_r_/_s_h_a_r_e_/_m_i_s_c_/_t_e_r_m_c_a_p, in that order, unless the en­
  47.      vironment variable TERMPATH exists, in which case it specifies a list of
  48.      file pathnames (separated by spaces or colons) to be searched instead.
  49.      Whenever multiple files are searched and a ttcc field occurs in the re­
  50.      quested entry, the entry it names must be found in the same file or one
  51.      of the succeeding files.  This can speed up entry into programs that call
  52.      ttggeetteenntt(), as well as help debug new terminal descriptions or make one
  53.      for your terminal if you can't write the file _/_u_s_r_/_s_h_a_r_e_/_m_i_s_c_/_t_e_r_m_c_a_p.
  54.  
  55.      The ttggeettnnuumm() function gets the numeric value of capability _i_d, returning
  56.      -1 if is not given for the terminal.  The ttggeettffllaagg() function returns 1
  57.      if the specified capability is present in the terminal's entry, 0 if it
  58.      is not.  The ttggeettssttrr() function returns the string value of the capabili­
  59.      ty _i_d, places it in the buffer at _a_r_e_a, and advances the _a_r_e_a pointer.
  60.      It decodes the abbreviations for this field described in termcap(5),  ex­
  61.      cept for cursor addressing and padding information.  The ttggeettssttrr() func­
  62.      tion returns NULL if the capability was not found.
  63.  
  64.      The ttggoottoo() function returns a cursor addressing string decoded from _c_m
  65.      to go to column _d_e_s_t_c_o_l in line _d_e_s_t_l_i_n_e. It uses the external variables
  66.      _U_P (from the uupp capability) and _B_C (if bbcc is given rather than bbss) if
  67.      necessary to avoid placing \\nn, ^^DD or ^^@@ in the returned string.  (Pro­
  68.      grams which call ttggoottoo() should be sure to turn off the XTABS bit(s),
  69.      since ttggoottoo() may now output a tab.  Note that programs using termcap
  70.      should in general turn off XTABS anyway since some terminals use control­
  71.      I for other functions, such as nondestructive space.)  If a %% sequence is
  72.      given which is not understood, then ttggoottoo() returns (OOPS).
  73.  
  74.      The ttppuuttss() function decodes the leading padding information of the
  75.      string _c_p; _a_f_f_c_n_t gives the number of lines affected by the operation, or
  76.      1 if this is not applicable, _o_u_t_c is a routine which is called with each
  77.      character in turn.  The external variable _o_s_p_e_e_d should contain the out­
  78.      put speed of the terminal as encoded by stty(3).  The external variable
  79.      _P_C should contain a pad character to be used (from the capability) if a
  80.      null (^^@@) is inappropriate.
  81.  
  82. FFIILLEESS
  83.      /usr/lib/libtermcap.a    --ll _l_t_e_r_m_c_a_p library (also known as --ll _l_t_e_r_m_l_i_b)
  84.      /usr/share/misc/termcap  standard terminal capability data base
  85.      $HOME/.termcap           user's terminal capability data base
  86.  
  87. SSEEEE AALLSSOO
  88.      ex(1),  curses(3),  termcap(5)
  89.  
  90. HHIISSTTOORRYY
  91.      The ttggeetteenntt functions appeared in 4.0BSD.
  92.  
  93. 4th Berkeley Distribution       April 19, 1991                               2
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.