resizeterm(3X) resizeterm(3X)

NAME
       iisstteerrmmrreessiizzeedd,  rreessiizzeetteerrmm,  rreessiizzeetteerrmm - change the curses terminal
       size

SYNOPSIS
       ##iinncclluuddee <>

       bbooooll iisstteerrmmrreessiizzeedd((iinntt lliinneess,, iinntt ccoolluummnnss));;
       iinntt rreessiizzeetteerrmm((iinntt lliinneess,, iinntt ccoolluummnnss));;
       iinntt rreessiizzeetteerrmm((iinntt lliinneess,, iinntt ccoolluummnnss));;

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

       Most  of the work is done by the inner function rreessiizzeetteerrmm.  The outer
       function rreessiizzeetteerrmm adds bookkeeping for the  SIGWINCH  handler.   When
       resizing  the  windows,  rreessiizzeetteerrmm  blank-fills  the  areas  that are
       extended.  The calling application should  fill  in  these  areas  with
       appropriate data.  The rreessiizzeetteerrmm function attempts to resize all win-
       dows.  However, due to the calling convention of pads, it is not possi-
       ble  to  resize  these without additional interaction with the applica-
       tion.

       A support function iisstteerrmmrreessiizzeedd is provided so that applications can
       check  if  the rreessiizzeetteerrmm function would modify the window structures.
       It returns TRUE if the windows would be modified, and FALSE  otherwise.

RREETTUURRNN VVAALLUUEE
       Except as notes, these function return the integer EERRRR upon failure and
       OOKK on success.  They will fail if either of  the  dimensions  are  less
       than  or equal to zero, or if an error occurs while (re)allocating mem-
       ory for the windows.

NNOOTTEESS
       While these functions are intended to be used to support a signal  han-
       dler  (i.e., for SIGWINCH), care should be taken to avoid invoking them
       in a context where mmaalllloocc or rreeaalllloocc may have been  interrupted,  since
       it uses those functions.

       If  ncurses  is  configured  to  supply  its  own SIGWINCH handler, the
       rreessiizzeetteerrmm function ungetch's a KKEEYYRREESSIIZZEE which will be  read  on  the
       next  call  to  ggeettcchh.   This  is used to alert an application that the
       screen size has changed, and that it should  repaint  special  features
       such as pads that cannot be done automatically.

       If  the  environment variables LLIINNEESS or CCOOLLUUMMNNSS are set, this overrides
       the library's use of the window size obtained from the  operating  sys-
       tem.   Thus,  even if a SIGWINCH is received, no screen size change may
       be recorded.  In that case, no KKEEYYRREESSIIZZEE is queued for the  next  call
       to ggeettcchh; an EERRRR will be returned instead.

SEE ALSO
       wwrreessiizzee(3X).

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



                                                                resizeterm(3X)