Section: Miscellaneous Library Functions (3X)
Return to Main Contents
wresize - resize a curses window
int wresize(WINDOW *win, int lines, int columns);
The wresize function reallocates storage for an ncurses
window to adjust its dimensions to the specified values.
If either dimension is larger than the current values, the
window's data is filled with blanks that have the current background rendition
(as set by wbkgndset) merged into them.
The function returns the integer ERR upon failure and OK on success.
It will fail if either of the dimensions less than or equal to zero,
or if an error occurs while (re)allocating memory for the window.
The only restriction placed on the dimensions is that they be greater than zero.
The dimensions are not compared to curses screen dimensions to
simplify the logic of resizeterm.
The caller must ensure that the window's dimensions fit within the
actual screen dimensions.
Thomas Dickey (from an equivalent function written in 1988 for BSD curses).
- RETURN VALUE
- SEE ALSO
This document was created by
using the manual pages.
Time: 23:07:34 GMT, May 09, 2009