Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
wresize(3X)			 Library calls			   wresize(3X)

NAME
       wresize - resize	a curses window

SYNOPSIS
       #include	<curses.h>

       int wresize(WINDOW * win, int lines, int	columns);

DESCRIPTION
       wresize,	 an ncurses extension to the curses library, reallocates stor-
       age for win, adjusting its dimensions to	lines and columns.  If	either
       dimension  is larger than its current value, ncurses fills the expanded
       part of the window with the window's background character as configured
       by wbkgdset(3X) (wide-character API: wbkgrndset(3X)).

RETURN VALUE
       wresize returns OK on success and ERR on	failure.  It fails  if	either
       lines  or  columns is less than or equal	to zero, or if an error	occurs
       while (re)allocating memory for win.

NOTES
       The only	restriction placed on the values of lines and columns is  that
       they  be	greater	than zero.  They are not compared to the dimensions of
       the curses screen; this keeps the logic of resizeterm(3X) simple.   The
       caller  must  ensure  that  win's  dimensions  fit  within those	of the
       screen.

EXTENSIONS
       wresize is an ncurses(3X) extension, and	is not found in	 SVr4  curses,
       4.4BSD curses, or any other previous curses implementation.

PORTABILITY
       Applications employing ncurses extensions should	condition their	use on
       the visibility of the NCURSES_VERSION preprocessor macro.

       NetBSD  curses adopted wresize in 2001 (release 1.5.3), and PDCurses in
       2004 (version 2.7).

       It is not possible to resize windows with SVr4 curses.

HISTORY
       Thomas Dickey developed wresize as an extension to BSD curses in	 1988,
       and brought it to ncurses in mid-1995.

AUTHORS
       Thomas Dickey

SEE ALSO
       resizeterm(3X)

ncurses	6.6			  2025-01-18			   wresize(3X)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=wresize&sektion=3&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>

home | help