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

wresize 3x 2024-07-27 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 fills the
       expanded part of the window with  the  blank  character  configured  by
       wbkgdset(3x) (wide-character API users: 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