Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

tigetstr(3xcurses) [opensolaris man page]

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)

Check Out this Related Man Page

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

NAME

       putp, tputs - apply padding information and output string

SYNOPSIS

       cc [ flag... ] file... -I /usr/xpg4/include  -L	/usr/xpg4/lib 
	-R  /usr/xpg4/lib  -lcurses  [ library... ]

       c89 [ flag... ] file... -lcurses [ library... ]

       #include <curses.h>

       int putp(const char *str);

       int tputs(const char *str, int affcnt, int (*putfunc) (int));

PARAMETERS

       str	  Is  a  pointer  to  a  terminfo  variable  or  return  value	from   tgetstr(3XCURSES),  tgoto(3XCURSES), tigetstr(3XCURSES), or
		  tparm(3XCURSES).

       affcnt	  Is the number of lines affected, or 1 if not relevant.

       putfunc	  Is the output function.

DESCRIPTION

       The putp() and tputs() functions are low-level functions used  to deal directly with the terminfo database.  The use of appropriate  X/Open
       Curses functions is recommended for most situations.

       The  tputs() function adds padding information and then outputs str. str must be a terminfo string variable or the result value from  tget-
       str(), tgoto(), tigetstr(), or tparm().	The tputs() function replaces the padding specification (if one exists) with enough characters	to
       produce the specified delay.  Characters are output one at a time to putfunc, a user-specified function similar to putchar(3C).

       The putp() function calls tputs() as follows:

       tputs(str, 1, putchar)

RETURN VALUES

       On success, these functions return OK.

ERRORS

       None.

USAGE

       The output of putp() goes to stdout, not to the file descriptor, fildes, specified in setupterm(3XCURSES).

ATTRIBUTES

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

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

SEE ALSO

       libcurses(3XCURSES), putchar(3C), setupterm(3XCURSES), tgetent(3XCURSES), tigetflag(3XCURSES), terminfo(4), attributes(5), standards(5)

SunOS 5.11							    5 Jun 2002							    putp(3XCURSES)
Man Page