icon Top 9 categories map      RocketAware > man pages >

resizeterm(3)

Tips: Browse or Search all pages for efficient awareness of more than 6000 of the most popular reusable and open source applications, functions, libraries, and FAQs.


The "RKT couplings" below include links to source code, updates, additional information, advice, FAQs, and overviews.


Home

Search all pages


Subjects

By activity
Professions, Sciences, Humanities, Business, ...

User Interface
Text-based, GUI, Audio, Video, Keyboards, Mouse, Images,...

Text Strings
Conversions, tests, processing, manipulation,...

Math
Integer, Floating point, Matrix, Statistics, Boolean, ...

Processing
Algorithms, Memory, Process control, Debugging, ...

Stored Data
Data storage, Integrity, Encryption, Compression, ...

Communications
Networks, protocols, Interprocess, Remote, Client Server, ...

Hard World
Timing, Calendar and Clock, Audio, Video, Printer, Controls...

File System
Management, Filtering, File & Directory access, Viewers, ...

    

RocketLink!--> Man page versions:






resizeterm(3)                                       resizeterm(3)


NAME
       resizeterm - change the curses terminal size



SYNOPSIS
       #include <curses.h>

       int resizeterm(int lines, int columns);

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

       When  resizing  the  windows, the function blank-fills the
       areas that are extended. The  calling  application  should
       fill in these areas with appropriate data.

       The function attempts to resize all windows.  However, due
       to the calling convention of pads, it is not  possible  to
       resize  these  without  additional  interaction  with  the
       application.

RETURN VALUE
       The function returns the integer ERR upon failure  and  OK
       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.

NOTES
       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 malloc or realloc
       may have been interrupted, since it uses those  functions.

       If  curses  is  configured to supply its own SIGWINCH han-
       dler, the resizeterm function ungetch's a KEY_RESIZE which
       will  be  read on the next call to getch.  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.

SEE ALSO
       wresize(3).

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






                                                                1



Source: OpenBSD 2.6 man pages. Copyright: Portions are copyrighted by BERKELEY
SOFTWARE DESIGN, INC., The Regents of the University of California, Massachusetts
Institute of Technology, Free Software Foundation, FreeBSD Inc., and others.



(Corrections, notes, and links courtesy of RocketAware.com)


[Detailed Topics]
OpenBSD sources for resizeterm(3)


[Overview Topics]



RocketLink!--> Man page versions:






Rapid-Links: Search | About | Comments | Submit Path: RocketAware > man pages > resizeterm.3/
RocketAware.com is a service of Mib Software
Copyright 1999, Forrest J. Cavalier III. All Rights Reserved.
We welcome submissions and comments