resizeterm - change the curses terminal size


SYNOPSIS

       #include <curses.h>

       int resizeterm(int lines, int columns);


DESCRIPTION

       This  is  an extension to the curses library.  It provides
       callers with a hook into the ncurses data to  resize  win-
       dows, primarily for use by programs running in an X Window
       terminal (e.g., xterm).  The function  resizeterm  resizes
       the  standard  and current windows to the specified dimen-
       sions, and adjusts other  bookkeeping  data  used  by  the
       ncurses library that record the window dimensions.

       When  resizing  the  windows, the function blank-fills the
       areas that are extended. The  calling  application  should
       fill in these areas with appropriate data.

       The function does not resize other windows.


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 windows.


NOTES

       While this function is intended to be used  to  support  a
       signal  handler (i.e., for SIGWINCH), care should be taken
       to avoid invoking it in a context where malloc or  realloc
       may  have been interrupted, since it uses those functions.


SEE ALSO

       wresize(3x).


AUTHOR

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