redrawwin(3curses)

redrawwin -- line update status functions

Synopsis

cc [options] file -lcurses

#include <curses.h>

int redrawwin(WINDOW *win);

int wredrawln(WINDOW *win, int beg_line, int num_lines);

Description

The redrawwin(3curses) and wredrawln(3curses) functions inform the implementation that some or all of the information physically displayed for the specified window may have been corrupted. The redrawwin(3curses) function marks the entire window; wredrawln(3curses) marks only num_lines lines starting at line number beg_line. The functions prevent the next refresh operation on that window from performing any optimisation based on assumptions about what is physically displayed there.

Return value

Upon successful completion, these functions return OK. Otherwise they return ERR.

Errors

No errors are defined.

Usage

The redrawwin(3curses) and wredrawln(3curses) functions could be used in a text editor to implement a command that redraws some or all of the screen.

Standards Conformance

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

References

clearok(3curses), doupdate(3curses), curses(4)