wresize(3x) Library calls wresize(3x)
wresize - resize a curses window
#include <curses.h>
int wresize(WINDOW * win, int lines, int columns);
wresize, an ncurses extension to the curses library, reallocates
storage for win, adjusting its dimensions to lines and columns. If
either dimension is larger than its current value, ncurses fills the
expanded part of the window with the blank character configured by
wbkgdset(3x) (wide-character API users: wbkgrndset(3x)).
wresize returns OK on success and ERR on failure. It fails if either
lines or columns is less than or equal to zero, or if an error occurs
while (re)allocating memory for win.
The only restriction placed on the values of lines and columns is that
they be greater than zero. They are not compared to the dimensions of
the curses screen; this keeps the logic of resizeterm(3x) simple. The
caller must ensure that win's dimensions fit within those of the
screen.
wresize is an ncurses(3x) extension, and is not found in SVr4 curses,
4.4BSD curses, or any other previous curses implementation.
Applications employing ncurses extensions should condition their use on
the visibility of the NCURSES_VERSION preprocessor macro.
NetBSD curses adopted wresize in 2001 (release 1.5.3), and PDCurses in
2004 (version 2.7).
It is not possible to resize windows with SVr4 curses.
Thomas Dickey developed wresize as an extension to BSD curses in 1988,
and brought it to ncurses in mid-1995.
Thomas Dickey
resizeterm(3x)
ncurses 6.5 2024-07-27 wresize(3x)