is_linetouched(CURSES)

is_linetouched -- window refresh control functions

Synopsis

cc [options] file -lcurses

#include <curses.h>

bool is_linetouched(WINDOW *win, int line);

bool is_wintouched(WINDOW *win);

int touchline(WINDOW *win, int start, int count);

int touchwin(WINDOW *win);

int untouchwin(WINDOW *win);

int wtouchln(WINDOW *win, int y, int n, int changed);

Description

The touchwin(CURSES) function touches the specified window (that is, marks it as having changed more recently than the last refresh operation). The touchline(CURSES) function only touches count lines, beginning with line start.

The untouchwin(CURSES) function marks all lines in the window as unchanged since the last refresh operation.

Calling wtouchln(CURSES), if changed is 1, touches n lines in the specified window, starting at line y. If changed is 0, wtouchln(CURSES) marks such lines as unchanged since the last refresh operation.

The is_wintouched(CURSES) function determines whether the specified window is touched. The is_linetouched(CURSES) function determines whether line line of the specified window is touched.

Return value

The is_linetouched(CURSES) and is_wintouched(CURSES) functions return TRUE if any of the specified lines, or the specified window, respectively, has been touched since the last refresh operation. Otherwise, they return FALSE.

Upon successful completion, the other functions return OK. Otherwise, they return ERR. Exceptions to this are noted in the preceding function descriptions.

Errors

No errors are defined.

Usage

Calling touchwin(CURSES) or touchline(CURSES) 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.

Standards Conformance

The Single UNIX Specification, Version 2; The Open Group.

References

``Definitions'', doupdate(CURSES), curses(F)