PUTP(3XCURSES) X/Open Curses Library Functions PUTP(3XCURSES)
putp, tputs - apply padding information and output string
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));
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.
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
tgetstr(), 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)
On success, these functions return OK.
None.
The output of putp() goes to stdout, not to the file descriptor,
fildes, specified in setupterm(3XCURSES).
See attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | Unsafe |
+--------------------+-----------------+
putchar(3C), libcurses(3XCURSES), setupterm(3XCURSES),
tgetent(3XCURSES), tigetflag(3XCURSES), terminfo(5), attributes(7),
standards(7)
June 5, 2002 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
tgetstr(), 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(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | Unsafe |
+--------------------+-----------------+
SEE ALSO
putchar(3C), libcurses(3XCURSES), setupterm(3XCURSES),
tgetent(3XCURSES), tigetflag(3XCURSES), terminfo(5), attributes(7),
standards(7)
June 5, 2002 PUTP(3XCURSES)