bionic (3) wresize.3ncurses.gz

Provided by: ncurses-doc_6.1-1ubuntu1.18.04.1_all bug

NAME
       wresize - resize a curses window


SYNOPSIS
       #include <curses.h>

       int wresize(WINDOW *win, int lines, int columns);


DESCRIPTION
       This  is  an extension to the curses library.  It reallocates storage for an ncurses window to adjust its
       dimensions to the specified values.  If either dimension is larger than the current values, the  window's
       data  is  filled  with blanks that have the current background rendition (as set by wbkgdset) merged into
       them.


RETURN VALUE
       The function returns the integer ERR upon failure and OK on success.  It  will  fail  if  either  of  the
       dimensions less than or equal to zero, or if an error occurs while (re)allocating memory for the window.


NOTES
       The  only restriction placed on the dimensions is that they be greater than zero.  The dimensions are not
       compared to curses screen dimensions to simplify the logic of resizeterm.  The caller  must  ensure  that
       the window's dimensions fit within the actual screen dimensions.


PORTABILITY
       It is not possible to resize windows with SVr4 curses.

       This  extension  of  ncurses  was  introduced  in  mid-1995.   It was adopted in NetBSD curses (2001) and
       PDCurses (2003).


SEE ALSO
       resizeterm(3NCURSES).


AUTHOR
       Thomas Dickey (from an equivalent function written in 1988 for BSD curses).

                                                                                               wresize(3NCURSES)