Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
X/Open Curses Library Functionsputp(3XCURSES)


NAME

 putp, tputs - apply padding information and output string

SYNOPSIS

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

SEE ALSO

 

putchar(3C), setupterm(3XCURSES), tgetent(3XCURSES), tigetflag(3XCURSES), terminfo(4)


SunOS 5.9Go To TopLast Changed 1 Jun 1996

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.