<HTML>
<BODY>
<PRE>
- <STRONG>resizeterm</STRONG> - change the curses terminal size
+<!-- Manpage converted by man2html 3.0.1 -->
+
+</PRE>
+<H2>NAME</H2><PRE>
+ <B>resizeterm</B> - change the curses terminal size
</PRE>
<H2>SYNOPSIS</H2><PRE>
- <STRONG>#include</STRONG> <STRONG><curses.h></STRONG>
+ <B>#include</B> <B><curses.h></B>
- <STRONG>int</STRONG> <STRONG>resizeterm(int</STRONG> <STRONG>lines,</STRONG> <STRONG>int</STRONG> <STRONG>columns);</STRONG>
+ <B>int</B> <B>resizeterm(int</B> <B>lines,</B> <B>int</B> <B>columns);</B>
</PRE>
<H2>DESCRIPTION</H2><PRE>
This is an extension to the curses library. It provides
- callers with a hook into the <STRONG>ncurses</STRONG> data to resize win-
+ callers with a hook into the <B>ncurses</B> data to resize win-
dows, primarily for use by programs running in an X Window
- terminal (e.g., xterm). The function <STRONG>resizeterm</STRONG> resizes
+ terminal (e.g., xterm). The function <B>resizeterm</B> resizes
the standard and current windows to the specified dimen-
sions, and adjusts other bookkeeping data used by the
- <STRONG>ncurses</STRONG> library that record the window dimensions.
+ <B>ncurses</B> library that record the window dimensions.
When resizing the windows, the function blank-fills the
areas that are extended. The calling application should
</PRE>
<H2>RETURN VALUE</H2><PRE>
- The function returns the integer <STRONG>ERR</STRONG> upon failure and <STRONG>OK</STRONG>
+ The function returns the integer <B>ERR</B> upon failure and <B>OK</B>
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.
<H2>NOTES</H2><PRE>
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 <STRONG>malloc</STRONG> or <STRONG>realloc</STRONG>
+ to avoid invoking it 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 SIGWINCH han-
- dler, the <STRONG>resizeterm</STRONG> function ungetch's a <STRONG>KEY_RESIZE</STRONG> which
- will be read on the next call to <STRONG>getch</STRONG>. This is used to
+ dler, the <B>resizeterm</B> function ungetch's a <B>KEY_RESIZE</B> which
+ will be read on the next call to <B>getch</B>. 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.
</PRE>
<H2>SEE ALSO</H2><PRE>
- <STRONG><A HREF="wresize.3x.html">wresize(3X)</A></STRONG>.
+ <B><A HREF="wresize.3x.html">wresize(3x)</A></B>.
</PRE>
for BSD curses).
+
</PRE>
+<HR>
+<ADDRESS>
+Man(1) output converted with
+<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
+</ADDRESS>
</BODY>
</HTML>