putp(3xcurses)

1putp(3XCURSES)          X/Open Curses Library Functions         putp(3XCURSES)
2
3
4

NAME

6       putp, tputs - apply padding information and output string
7

SYNOPSIS

9       cc [ flag... ] file... -I /usr/xpg4/include  -L  /usr/xpg4/lib \
10        -R  /usr/xpg4/lib  -lcurses  [ library... ]
11
12       c89 [ flag... ] file... -lcurses [ library... ]
13
14       #include <curses.h>
15
16       int putp(const char *str);
17
18
19       int tputs(const char *str, int affcnt, int (*putfunc) (int));
20
21

PARAMETERS

23       str        Is  a  pointer  to  a terminfo variable or return value from
24                  tgetstr(3XCURSES), tgoto(3XCURSES),  tigetstr(3XCURSES),  or
25                  tparm(3XCURSES).
26
27
28       affcnt     Is the number of lines affected, or 1 if not relevant.
29
30
31       putfunc    Is the output function.
32
33

DESCRIPTION

35       The  putp() and tputs() functions are low-level functions used  to deal
36       directly with the terminfo database.  The  use  of  appropriate  X/Open
37       Curses functions is recommended for most situations.
38
39
40       The tputs() function adds padding information and then outputs str. str
41       must be a terminfo string variable or the result value from  tgetstr(),
42       tgoto(),  tigetstr(),  or  tparm().   The tputs() function replaces the
43       padding specification (if one exists) with enough characters to produce
44       the specified delay.  Characters are output one at a time to putfunc, a
45       user-specified function similar to putchar(3C).
46
47
48       The putp() function calls tputs() as follows:
49
50
51       tputs(str, 1, putchar)
52

RETURN VALUES

54       On success, these functions return OK.
55

ERRORS

57       None.
58

USAGE

60       The output of putp() goes  to  stdout,  not  to  the  file  descriptor,
61       fildes, specified in setupterm(3XCURSES).
62

ATTRIBUTES

64       See attributes(5) for descriptions of the following attributes:
65
66
67
68
69       ┌─────────────────────────────┬─────────────────────────────┐
70       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
71       ├─────────────────────────────┼─────────────────────────────┤
72       │Interface Stability          │Standard                     │
73       ├─────────────────────────────┼─────────────────────────────┤
74       │MT-Level                     │Unsafe                       │
75       └─────────────────────────────┴─────────────────────────────┘
76