TIGETFLAG(3XCURSES) X/Open Curses Library Functions TIGETFLAG(3XCURSES)

tigetflag, tigetnum, tigetstr, tparm - return the value of a terminfo capability

cc [ flag... ] file... -I /usr/xpg4/include  -L  /usr/xpg4/lib \
 -R  /usr/xpg4/lib  -lcurses  [ library... ]
c89 [ flag... ] file... -lcurses [ library... ]
#include <term.h>
int tigetflag(char *capname);

int tigetnum(char *capname);

char *tigetstr(char *capname);

char *tparm(char *cap, long p1, long p2, long p3, long p4, long p5,
     long p6, long p7,long p8, long p9);

capname
Is the name of the terminfo capability for which the value is required.

cap

Is a pointer to a string capability.

p1...p9

Are the parameters to be instantiated.

The tigetflag(), tigetnum(), and tigetstr() functions return values for terminfo capabilities passed to them.

The following null-terminated arrays contain the capnames, the termcap codes and full C names for each of the terminfo variables.


char *boolnames, *boolcodes, *boolfnames
char *numnames, *numcodes, *numfnames
char *strnames, *strcodes, *strfnames

The tparm() function instantiates a parameterized string using nine arguments. The string is suitable for output processing by tputs().

On success, the tigetflg(), tigetnum(), and tigetstr() functions return the specified terminfo capability.

tigetflag() returns −1 if capname is not a Boolean capability.

tigetnum() returns −2 if capname is not a numeric capability.

tigetstr() returns (char *)−1 if capname is not a string capability.

On success, the tparm() function returns cap in a static buffer with the parameterization resolved. Otherwise, it returns a null pointer.

None.

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE
Interface Stability Standard
MT-Level Unsafe

libcurses(3XCURSES), tgetent(3XCURSES), terminfo(4), attributes(5), standards(5)

June 5, 2002 OmniOS