TERMCAP.3
上传用户:jnzhq888
上传日期:2007-01-18
资源大小:51694k
文件大小:4k
源码类别:

操作系统开发

开发平台:

WINDOWS

  1. TERMCAP(3)                Minix Programmer's Manual                 TERMCAP(3)
  2. NAME
  3.      termcap, tgetent, tgetnum, tgetflag, tgetstr,  tgoto,  tputs  -  terminal
  4.      independent operation routines
  5. SYNOPSIS
  6.      #include <termcap.h>
  7.      int tgetent(char *bp, char *name)
  8.      int tgetflag(char *id)
  9.      int tgetnum(char *id)
  10.      char *tgetstr(char *id, char **area)
  11.      char *tgoto(char *cm, int destcol, int destline)
  12.      int tputs(char *cp, int affcnt, void (*outc)(int))
  13. DESCRIPTION
  14.      These functions extract and use capabilities from the terminal capability
  15.      data  base termcap(5).  These are low level routines; see curses(3) for a
  16.      higher level package.
  17.      Tgetent extracts the entry for terminal name into the buffer at  bp.   Bp
  18.      should  be  a  character buffer of size 1024 and must be retained through
  19.      all subsequent calls to tgetnum, tgetflag, and tgetstr.  Tgetent  returns
  20.      -1  if  it  cannot find a termcap file, 0 if the terminal name given does
  21.      not have an entry, and 1 if all goes well.
  22.      Tgetent uses the following recipe to find  the  termcap  file  and  entry
  23.      name:
  24.           if $TERMCAP is itself a termcap entry for name
  25.           then
  26.                use $TERMCAP
  27.           elif $TERMCAP names a file
  28.           then
  29.                use entry name found in that file
  30.           elif this is Minix-vmd
  31.           then
  32.                if $TERMPATH is defined
  33.                then
  34.                     search the termcap files named in $TERMPATH for the  first
  35.                     occurance of a name entry and use that entry
  36.                else
  37.                     the path $HOME/.termcap:/etc/termcap:/usr/etc/termcap"  is
  38.                     searched for entry name
  39.                fi
  40.           fi
  41.      Tgetnum gets the numeric value of capability id, returning -1 if  is  not
  42.      given  for  the terminal.  Tgetflag returns 1 if the specified capability
  43.      is present in the terminal's entry, 0 if it is not.  Tgetstr returns  the
  44.      string  value  of the capability id, places it in the buffer at area, and
  45. 4BSD                              May 15, 1985                               1
  46. TERMCAP(3)                Minix Programmer's Manual                 TERMCAP(3)
  47.      advances the area pointer.  It decodes the abbreviations for  this  field
  48.      described  in  termcap(5),  except  for  cursor  addressing  and  padding
  49.      information.  Tgetstr returns NULL if the capability was not found.
  50.      Tgoto returns a cursor addressing string decoded from cm to go to  column
  51.      destcol in line destline.  It uses the external variables UP (from the up
  52.      capability) and BC (if bc is given rather than bs) if necessary to  avoid
  53.      placing  n, ^D or ^@ in the returned string.  (Programs which call tgoto
  54.      should be sure to turn off the XTABS bit(s), since tgoto may now output a
  55.      tab.   Note  that programs using termcap should in general turn off XTABS
  56.      anyway since some terminals use  CTRL-I  for  other  functions,  such  as
  57.      nondestructive space.)  If a % sequence is given which is not understood,
  58.      then tgoto returns "OOPS".
  59.      Tputs decodes the leading padding information of the  string  cp;  affcnt
  60.      gives  the number of lines affected by the operation, or 1 if this is not
  61.      applicable, outc is a routine which is  called  with  each  character  in
  62.      turn.   The  external  variable ospeed should contain the output speed of
  63.      the terminal as encoded by stty(3).   The  external  variable  PC  should
  64.      contain  a  pad  character  to be used (from the pc capability) if a null
  65.      (^@) is inappropriate.
  66. SEE ALSO
  67.      curses(3), termcap(5).
  68. AUTHOR
  69.      William Joy
  70. NOTES
  71.      The Minix implementation does not support any of the external  variables,
  72.      only  the  functions  calls.   The Minix-vmd termcap does support it all,
  73.      although noone in his right mind meddles with those variables.
  74. 4BSD                              May 15, 1985                               2