Content-type: text/html Man page of curs_termcap

curs_termcap

Section: C Library Functions (3)
Index Return to Main Contents
 

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:  XPG4-UNIX

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

NAME
SYNOPSIS
LIBRARY
STANDARDS
DESCRIPTION
NOTES
RETURN VALUES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:41:13 GMT, October 02, 2010