manpagez: man pages & more
man wresize(3)
Home | html | info | man
wresize(3)                      Library calls                     wresize(3)


NAME

       wresize - resize a curses window


SYNOPSIS

       #include <curses.h>

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


DESCRIPTION

       This ncurses extension to standard curses reallocates storage for a
       curses window to adjust its dimensions to the specified values.  If
       either dimension is larger than its current value, the expanded part of
       the window is filled with blanks merged with current background
       rendition (as set by wbkgdset(3X)).


RETURN VALUE

       wresize returns ERR upon failure and OK on success.  It will fail if
       either of the dimensions is 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.  They are not compared to the curses screen dimensions; this
       keeps the logic of resizeterm(3X) simple.  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.

       ncurses introduced this extension in mid-1995.  NetBSD curses adopted
       it in 2001, and PDCurses in 2003.


AUTHORS

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


SEE ALSO

       resizeterm(3X)

ncurses 6.5                       2024-03-16                       wresize(3)

ncurses 6.5 - Generated Tue May 7 08:18:38 CDT 2024
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.