HP-UX Reference (11i v1 05/09) - 3 Library Functions N-Z (vol 7)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

481

482

483

484

485

486

487

488

489

490

tgetent(3X) tgetent(3X)

(ENHANCED CURSES)

NAME

tgetent, tgetﬂag, tgetnum, tgetstr, tgoto — termcap database emulation (TO BE WITHDRAWN)

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(char *cap, int col, int row);

DESCRIPTION

The tgetent() function looks up the termcap entry for name. The emulation ignores the buffer pointer

bp.

The

tgetflag() function gets the boolean entry for id.

The tgetnum() function gets the numeric entry for id.

The tgetstr() function gets the string entry for id.Ifarea is not a null pointer and does not point to a

null pointer, tgetstr() copies the string entry into the buffer pointed to by *area and advances the vari-

able pointed to by area to the ﬁrst byte after the copy of the string entry.

The

tgoto() function instantiates col and row into cap and returns a pointer to the resulting string.

All of the information available in the terminfo database need not be available through these functions.

Information about non-standard tgetent and tgetflag() is in the termcap(3X) manpage.

RETURN VALUE

Upon successful completion, functions that return an integer will return 0K (0). Otherwise, they return

ERR (-1).

Functions that return pointers will return a null pointer on error.

ERRORS

No errors are deﬁned.

APPLICATION USAGE

These functions are included as a conversion aid for programs that use the termcap library. Their argu-

ments are the same and the functions are emulated using the terminfo database.

These functions are only guaranteed to operate reliably on character sets in which each character ﬁts into a

single byte, whose attributes can be expressed using only constants with the A_ preﬁx.

Any terminal capabilities from the terminfo database that cannot be retrieved using these interfaces can

be retrieved using the interfaces described on the

tigetflg() page.

Portable applications must use tputs() to output the strings returned by tgetstr() and tgoto().