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