|
|
#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);
The tparm(3curses) function takes as cap a string capability. If cap is parameterised tparm(3curses) resolves the parameterisation. If the parameterised string refers to parameters p1 through %p9, then tparm(3curses) substitutes the values of p1 through p9, respectively.
Upon successful completion, tparm(3curses) returns str with parameterisation resolved. Otherwise, it returns a null pointer.
Applications intending to send terminal capabilities directly to the terminal (which should only be done using tputs(3curses) or putp(3curses)) instead of using Curses, normally should obey the following rules:
enter_ca_mode
upon
startup and output exit_ca_mode
before exiting.
exit_ca_mode
and call
reset_shell_mode(3curses)
before calling the shell; call
reset_prog_mode(3curses)
and output
enter_ca_mode
after returning from the shell.
All parameterised terminal capabilities defined in this document can be passed to tparm(3curses). Some implementations create their own capabilities, create capabilities for non-terminal devices, and redefine the capabilities in this document. These practices are non-conforming because it may be that tparm(3curses) cannot parse these user-defined strings.