Index for Section 3

Alphabetical listing for C

Bottom of page

curs_termcap(3)
NAME
  curs_termcap, tgetent, tgetflag, tgetnum, tgetstr, tgoto - Curses
  interfaces that support termcap capabilities

SYNOPSIS
  #include <term.h>

  int tgetent(
	  char *bp,
	  const char *name );

  int tgetflag(
	  char id[2] );

  int tgetnum(
	  char id[2] );

  char *tgetstr(
	  char id[2],
	  char **area );

  char *tgoto(
	  const char *cap,
	  int col,
	  int row );

LIBRARY
  Curses Library (libcurses)

STANDARDS
  Interfaces documented on this reference page conform to industry standards
  as follows:

  tgetent, tgetflag, tgetnum, tgetstr, tgoto:  XCURSES4.2

  Refer to the standards(5) reference page for more information about
  industry standards and associated tags.

DESCRIPTION
  These routines are obsolete and should not be used in new applications.
  The routines are included in the Curses library as a conversion aid for
  applications originally designed to use the termcap file. The routines
  include the same parameters as used with the termcap file but their
  operations are emulated by using the terminfo database.

  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. Applications use the
  tputs routine to output the returned string.

  The tgoto routine instantiates the parameters into the given capability.
  Applications pass output from this routine to the tputs routine.

  The tputs routine is described in the curs_terminfo(3) reference page.

NOTES
  The header file <curses.h> automatically includes the header file
  <stdio.h>.

RETURN VALUES
  Routines that return an integer return ERR upon failure and OK upon
  successful completion.

  Routines that return pointers return NULL on error.

SEE ALSO
  Functions: curses(3), curs_terminfo(3), putc(3)

  Others: standards(5)

Index for Section 3

Alphabetical listing for C

Top of page