opensolaris man page for tparm

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

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

SYNOPSIS
       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);

PARAMETERS
       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.

DESCRIPTION
       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().

RETURN VALUES
       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.

ERRORS
       None.

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

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

SunOS 5.11							    5 Jun 2002						       tigetflag(3XCURSES)