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 storage
     for win, adjusting its dimensions to lines and columns.  If  either  dimen-
     sion  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