https://invisible-island.net/ncurses/man/

wresize 3x 2024-09-21 ncurses 6.5 Library calls

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 the expanded
       part of the window is filled with blanks merged with current background
       rendition  (configured  by  wbkgdset(3x),  or  by  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