+
+</PRE><H3><a name="h3-is_term_resized">is_term_resized</a></H3><PRE>
+ A support function <B>is_term_resized</B> is provided so that applications can
+ check if the <B>resize_term</B> function would modify the window structures.
+ It returns <B>TRUE</B> if the windows would be modified, and <B>FALSE</B> otherwise.
+
+
+</PRE><H2><a name="h2-RETURN-VALUE">RETURN VALUE</a></H2><PRE>
+ Except as noted, these functions return the integer <B>ERR</B> upon failure
+ and <B>OK</B> 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
+ memory for the windows.
+
+
+</PRE><H2><a name="h2-NOTES">NOTES</a></H2><PRE>
+ While these functions are intended to be used to support a signal
+ handler (i.e., for <B>SIGWINCH</B>), care should be taken to avoid invoking
+ them in a context where <B>malloc</B> or <B>realloc</B> may have been interrupted,
+ since it uses those functions.
+
+ If ncurses is configured to supply its own <B>SIGWINCH</B> handler,
+
+ <B>o</B> on receipt of a <B>SIGWINCH</B>, the handler sets a flag
+
+ <B>o</B> which is tested in <B><A HREF="curs_getch.3X.html">wgetch(3X)</A></B> and <B>doupdate</B>,
+
+ <B>o</B> in turn, calling the <B>resizeterm</B> function,
+
+ <B>o</B> which <B>ungetch</B>'s a <B>KEY_RESIZE</B> which will be read on the next call to
+ <B>wgetch</B>.
+
+ The <B>KEY_RESIZE</B> alerts an application that the screen size has
+ changed, and that it should repaint special features such as pads
+ that cannot be done automatically.
+
+ Calling <B>resizeterm</B> or <B>resize_term</B> directly from a signal handler is
+ unsafe. This indirect method is used to provide a safe way to
+ resize the ncurses data structures.
+
+ If the environment variables <B>LINES</B> or <B>COLUMNS</B> are set, this overrides
+ the library's use of the window size obtained from the operating
+ system. Thus, even if a <B>SIGWINCH</B> is received, no screen size change
+ may be recorded.
+
+
+</PRE><H2><a name="h2-PORTABILITY">PORTABILITY</a></H2><PRE>
+ It is possible to resize the screen with SVr4 curses, by
+
+ <B>o</B> exiting curses with <B><A HREF="curs_initscr.3X.html">endwin(3X)</A></B> and
+
+ <B>o</B> resuming using <B><A HREF="curs_refresh.3X.html">refresh(3X)</A></B>.
+
+ Doing that clears the screen and is visually distracting.
+
+ This extension of ncurses was introduced in mid-1995. It was adopted
+ in NetBSD curses (2001) and PDCurses (2003).
+
+
+</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
+ <B><A HREF="curs_getch.3X.html">curs_getch(3X)</A></B>, <B><A HREF="curs_variables.3X.html">curs_variables(3X)</A></B>, <B><A HREF="wresize.3X.html">wresize(3X)</A></B>.
+
+
+</PRE><H2><a name="h2-AUTHOR">AUTHOR</a></H2><PRE>
+ Thomas Dickey (from an equivalent function written in 1988 for BSD
+ curses).