termcap(3X)															       termcap(3X)

NAME

       termcap: tgetent(), tgetflag(), tgetnum(), tgetstr(), tgoto(), tputs() - emulate /usr/share/lib/termcap access routines

SYNOPSIS

DESCRIPTION

       These  functions  extract and use capabilities from the compiled terminal capability data bases (see terminfo(4)).  They are emulation rou-
       tines.

	      Extracts the compiled entry for terminal
			     name into buffers accessible by the programmer.  Unlike previous termcap routines,  all  capability  strings  (except
			     cursor  addressing  and  padding  information) are already compiled and stored internally upon return from The buffer
			     pointer bp is redundant in the emulation, and is ignored.	It should not be relied upon to point to meaningful infor-
			     mation.   returns	-1 if it cannot access the terminfo directory or if there is no capability file for name, and 0 if
			     all goes well.  If a environment variable is set, first looks for (where is the first character of name), and if that
			     file is not accessible, it looks for

	      Gets the numeric value of capability
			     id, returning -1 if it is not given for the terminal.  is useful only with capabilities having numeric values.

	      Returns 1 if the specified capability is present in
			     the  terminal's  entry, and 0 if it is not.  is useful only with capabilities that are boolean in nature (i.e. either
			     present or missing in terminfo(4)).

	      Returns a pointer to the string value of capability
			     id.  In addition, if area is not a NULL pointer, places the capability in the buffer at area and  advances  the  area
			     pointer.  The returned string capability is compiled except for cursor addressing and padding information.  is useful
			     only with capabilities having string values.

	      Returns a cursor addressing string decoded from
			     cm to go to column destcol in line destline.  (Programs that call should be sure to turn off the TAB3  bit  or  bits,
			     since  can  now output a tab.  See termio(7)).  Note that programs using should in general turn off TAB3 anyway since
			     some terminals use Ctrl-I for other functions, such as nondestructive space.)  If a sequence is  given  that  is  not
			     understood, returns [OOPS].

	      Decodes the padding information of the string
			     cp.   affcnt  gives the number of lines affected by the operation, or 1 if this is not applicable.  outc is a routine
			     that is called with each character in turn.  The variable pad_char should contain a pad character to  be  used  (from
			     the pc capability) if a null is inappropriate.

WARNINGS

       These routines are not meant to be used by programs running in the background.

   Obsolescent Interfaces
       and are to be obsoleted at a future date.

FILES

       library
       data bases

SEE ALSO

       ex(1), terminfo(4), termio(7).

								  TO BE OBSOLETED						       termcap(3X)