wredrawln(3xcurses)

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

NAME

6       redrawwin, wredrawln - redraw screen or portion of screen
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 redrawwin(WINDOW *win);
17
18
19       int wredrawln(WINDOW *win, int beg_line, int num_lines);
20
21

PARAMETERS

23       win          Is a pointer to the window in which to redraw.
24
25
26       beg_line     Is the first line to redraw.
27
28
29       num_lines    Is the number of lines to redraw.
30
31

DESCRIPTION

33       The redrawwin() and wredrawln() functions force portions of a window to
34       be redrawn to the terminal when the  next  refresh  operation  is  per‐
35       formed.
36
37
38       The  redrawwin()  function  forces the entire window win to be redrawn,
39       while the wredrawln() function forces  only  num_lines  lines  starting
40       with beg_line to be redrawn. Normally, refresh operations use optimiza‐
41       tion methods to reduce the actual amount of the screen to redraw  based
42       on  the  current  screen  contents.    These functions tell the refresh
43       operations not to attempt any optimization  when  redrawing  the  indi‐
44       cated areas.
45
46
47       These  functions  are useful when the data that exists on the screen is
48       believed  to be corrupt and for applications  such  as  screen  editors
49       that redraw portions of the screen.
50

RETURN VALUES

52       On success, these functions return OK. Otherwise, they return ERR.
53

ERRORS

55       None.
56

ATTRIBUTES

58       See attributes(5) for descriptions of the following attributes:
59
60
61
62
63       ┌─────────────────────────────┬─────────────────────────────┐
64       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
65       ├─────────────────────────────┼─────────────────────────────┤
66       │Interface Stability          │Standard                     │
67       ├─────────────────────────────┼─────────────────────────────┤
68       │MT-Level                     │Unsafe                       │
69       └─────────────────────────────┴─────────────────────────────┘
70