wresize(3X)                      Library calls                     wresize(3X)

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
     dimension is larger than its current value, ncurses fills the expanded
     part of the window with the window's background character as configured
     by wbkgdset(3X) (wide-character API: wbkgrndset(3X)).

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(3X) simple.  The
     caller must ensure that win's dimensions fit within those of the screen.

EXTENSIONS

     wresize is an ncurses(3X) 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(3X)

ncurses 6.6                       2025-01-18                       wresize(3X)