'\" te
.\"  Copyright (c) 1990, 1995 by Mortice Kern Systems Inc.  All Rights Reserved  Portions Copyright (c) 1996, Sun Microsystems, Inc.  All Rights Reserved
.TH putp 3XCURSES "5 Jun 2002" "SunOS 5.11" "X/Open Curses Library Functions"
.SH NAME
putp, tputs \- apply padding information and output string 
.SH SYNOPSIS
.LP
.nf
\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-I\fR /usr/xpg4/include \fB -L \fR /usr/xpg4/lib \e
\fB -R \fR /usr/xpg4/lib \fB -lcurses \fR [ \fIlibrary\fR... ]

\fBc89\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lcurses\fR [ \fIlibrary\fR... ]

#include <curses.h>

\fBint\fR \fBputp\fR(\fBconst char *\fR\fIstr\fR);
.fi

.LP
.nf
\fBint\fR \fBtputs\fR(\fBconst char *\fR\fIstr\fR, \fBint\fR \fIaffcnt\fR, \fBint (*\fR\fIputfunc\fR) (int));
.fi

.SH PARAMETERS
.sp
.ne 2
.mk
.na
\fB\fIstr\fR\fR
.ad
.RS 11n
.rt  
Is a pointer to a \fBterminfo\fR variable or return value from  \fBtgetstr\fR(3XCURSES), \fBtgoto\fR(3XCURSES), \fBtigetstr\fR(3XCURSES), or \fBtparm\fR(3XCURSES).
.RE

.sp
.ne 2
.mk
.na
\fB\fIaffcnt\fR\fR
.ad
.RS 11n
.rt  
Is the number of lines affected, or 1 if not relevant.
.RE

.sp
.ne 2
.mk
.na
\fB\fIputfunc\fR\fR
.ad
.RS 11n
.rt  
Is the output function.
.RE

.SH DESCRIPTION
.sp
.LP
The \fBputp()\fR and \fBtputs()\fR functions are low-level functions used  to deal directly with the \fBterminfo\fR database.  The use of appropriate X/Open Curses functions is recommended for most situations.
.sp
.LP
The \fBtputs()\fR function adds padding information and then outputs \fIstr\fR. \fIstr\fR must be a \fBterminfo\fR string variable or the result value from  \fBtgetstr()\fR, \fBtgoto()\fR, \fBtigetstr()\fR, or \fBtparm()\fR.  The \fBtputs()\fR function replaces the padding specification (if one exists) with enough characters to produce the specified delay.  Characters are output one at a time to \fIputfunc\fR, a user-specified function similar to \fBputchar\fR(3C).
.sp
.LP
The \fBputp()\fR function calls \fBtputs()\fR as follows:
.sp
.LP
\fBtputs(\fR\fIstr\fR, 1, putchar)
.SH RETURN VALUES
.sp
.LP
On success, these functions return \fBOK\fR.
.SH ERRORS
.sp
.LP
None.
.SH USAGE
.sp
.LP
The output of \fBputp()\fR goes to \fBstdout\fR, not to the file descriptor, \fIfildes\fR, specified in \fBsetupterm\fR(3XCURSES).
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Interface StabilityCommitted
_
MT-LevelUnsafe
_
StandardSee \fBstandards\fR(5).
.TE

.SH SEE ALSO
.sp
.LP
\fBlibcurses\fR(3XCURSES), \fBputchar\fR(3C), \fBsetupterm\fR(3XCURSES), \fBtgetent\fR(3XCURSES), \fBtigetflag\fR(3XCURSES), \fBterminfo\fR(4), \fBattributes\fR(5), \fBstandards\fR(5)