touchwin.3x (2010 09)

t
touchwin(3X) touchwin(3X)
(CURSES)
NAME
touchwin — window refresh control function
SYNOPSIS
#include <curses.h>
int touchwin(WINDOW *win);
DESCRIPTION
The touchwin() function touches the specified window (that is, marks it as having changed more
recently than the last refresh operation).
RETURN VALUE
Upon successful completion, the this function return OK. Otherwise, it returns ERR.
ERRORS
No errors are defined.
APPLICATION USAGE
Calling
touchwin() or touchline() is sometimes necessary when using overlapping windows, since
a change to one window affects the other window, but the records of which lines have been changed in the
other window do not reflect the change.
SEE ALSO
doupdate(3X), is_linetouched(3X), curses_intro(3X), see section Screens, Windows and Terminals,
<curses.h>.
CHANGE HISTORY
First released in X/Open Curses, Issue 2.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1