putp(3X)                                                           putp(3X)

NAME
     putp, tputs - output commands to the terminal

SYNOPSIS
     cc [flag ...] file ... -lcurses [library ...]

     #include <term.h>

     int putp(const char *str);

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

DESCRIPTION
     These functions output commands contained in the terminfo(4) database
     to the terminal.

     The putp() function is equivalent to tputs(str, 1, putchar). The out-
     put of putp() always goes to stdout, not to the fildes specified in
     setupterm().

     The tputs() function outputs str to the terminal. The str argument
     must be a terminfo string variable or the return value from tgetstr(),
     tgoto(), tigetstr() or tparm(). The affcnt argument is the number of
     lines affected, or 1 if not applicable. If the terminfo database indi-
     cates that the terminal in use requires padding after any command in
     the generated string, tputs() inserts pad characters into the string
     that is sent to the terminal, at positions indicated by the terminfo
     database. The tputs() function outputs each character of the generated
     string by calling the user-supplied function putfunc (see below).

     The user-supplied function putfunc (specified as an argument to
     tputs()) is either putchar() or some other function with the same pro-
     totype. The tputs() function ignores the return value of putfunc.

RETURN VALUE
     Upon successful completion, these functions return OK. Otherwise, they
     return ERR.

ERRORS
     No errors are defined.

NOTES
     Changing the terminal attributes using these functions may cause the
     renditions of characters within a curses window to be altered on some
     terminals.

     After use of any of these functions, the model Curses maintains of the
     state of the terminal might not match the actual state of the termi-
     nal. The application should touch and refresh the window before resum-
     ing conventional use of Curses.





Page 1                       Reliant UNIX 5.44                Printed 11/98

putp(3X)                                                           putp(3X)

SEE ALSO
     putchar(3S), curses(3X), doupdate(3X), islinetouched(3X),
     tgetent(3X), tigetflag(3X), terminfo(4), term(5).



















































Page 2                       Reliant UNIX 5.44                Printed 11/98