.TH wresize 3X "" .SH NAME \fBwresize\fR - resize a curses window .SH SYNOPSIS \fB#include <curses.h>\fR \fBint wresize(WINDOW *win, int lines, int columns);\fR .SH DESCRIPTION The \fBwresize\fR function adjusts the dimensions of an \fBncurses\fR window to the specified values, reallocating storage as necessary. 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 \fBwbkgndset\fR) merged into them. If the current cursor position is outside the retained area of the window, the cursor is moved to within the nearest window edge. Window data is otherwise preserved. This function will fail if either of the new dimensions less than or equal to zero, or if memory cannot be allocated or reallocated for the window. Note that \fBwresize\fR performs non-reentrant \fBmalloc\fR(3x) operations, so it isn't advisable to resize from within an interrupt handler. Instead, have your handler set an event flag to be interpreted next time around your program's command loop. .SH PORTABILITY This call was designed for \fBncurses\fR(3x), and is not found in SVr4 curses, 4.4BSD curses, or any other previous version of curses. It is recommended that you conditionalize all code depending on it with the symbol NCURSES. .SH RETURN VALUE The function returns the integer \fBERR\fR upon failure and \fBOK\fR on success. .\"# .\"# The following sets edit modes for GNU EMACS .\"# Local Variables: .\"# mode:nroff .\"# fill-column:79 .\"# End: