wresize(3NCURSES) Library calls wresize(3NCURSES)
NAME
wresize - resize a curses window
SYNOPSIS
#include <curses.h>
int wresize(WINDOW * win, int lines, int columns);
DESCRIPTION
wresize, an ncurses extension to the curses library, reallocates storage
for win, adjusting its dimensions to lines and columns. If either di-
mension is larger than its current value, ncurses fills the expanded
part of the window with the window's background character as configured
by wbkgdset(3NCURSES) (wide-character API: wbkgrndset(3NCURSES)).
RETURN VALUE
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.
NOTES
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(3NCURSES) simple.
The caller must ensure that win's dimensions fit within those of the
screen.
EXTENSIONS
wresize is an ncurses(3NCURSES) extension, and is not found in SVr4
curses, 4.4BSD curses, or any other previous curses implementation.
PORTABILITY
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.
HISTORY
Thomas Dickey developed wresize as an extension to BSD curses in 1988,
and brought it to ncurses in mid-1995.
AUTHORS
Thomas Dickey
SEE ALSO
resizeterm(3NCURSES)
ncurses 6.5 2025-01-18 wresize(3NCURSES)
Generated by dwww version 1.16 on Sat Oct 3 05:20:39 CEST 2026.