MirBSD manpage: curs_scr_dump(3), scr_dump(3), scr_init(3), scr_restore(3), scr_set(3)

curs_scr_dump(3)    UNIX Programmer's Manual     curs_scr_dump(3)


     scr_dump, scr_restore, scr_init, scr_set - read (write) a
     curses screen from (to) a file


     #include <curses.h>

     int scr_dump(const char *filename);
     int scr_restore(const char *filename);
     int scr_init(const char *filename);
     int scr_set(const char *filename);


     The scr_dump routine dumps the current contents of the  vir-
     tual screen to the file filename.

     The scr_restore routine sets the virtual screen to the  con-
     tents  of  filename,  which  must  have  been  written using
     scr_dump.  The next call to doupdate restores the screen  to
     the way it looked in the dump file.

     The scr_init routine reads in the contents of  filename  and
     uses  them  to  initialize  the curses data structures about
     what the terminal currently has on its screen.  If the  data
     is  determined  to be valid, curses bases its next update of
     the screen on this  information  rather  than  clearing  the
     screen  and  starting  from scratch.  scr_init is used after
     initscr or a system call to share the  screen  with  another
     process  which  has  done  a scr_dump after its endwin call.
     The data is declared invalid if  the  terminfo  capabilities
     rmcup and nrrmc exist; also if the terminal has been written
     to since the preceding scr_dump call.

     The scr_set routine is  a  combination  of  scr_restore  and
     scr_init.   It  tells  the  program  that the information in
     filename is what is currently on the screen, and  also  what
     the program wants on the screen. This can be thought of as a
     screen inheritance function.

     To read (write) a window from (to) a file,  use  the  getwin
     and putwin routines [see curs_util(3)].


     All routines return the integer ERR upon failure and OK upon

     X/Open defines no error conditions. In this  implementation,
     each will return an error if the file cannot be opened.


     Note that scr_init, scr_set, and scr_restore may be macros.

MirBSD #10-current     Printed 2022-12-23                       1

curs_scr_dump(3)    UNIX Programmer's Manual     curs_scr_dump(3)


     The XSI Curses standard, Issue 4, describes these  functions
     (adding the const qualifiers).

     The SVr4 docs merely say under scr_init that the  dump  data
     is  also considered invalid "if the time-stamp of the tty is
     old" but do not define "old".


     curses(3), curs_initscr(3),  curs_refresh(3),  curs_util(3),

MirBSD #10-current     Printed 2022-12-23                       2

Generated on 2022-12-24 01:00:14 by $MirOS: src/scripts/roff2htm,v 1.113 2022/12/21 23:14:31 tg Exp $ — This product includes material provided by mirabilos.

These manual pages and other documentation are copyrighted by their respective writers; their sources are available at the project’s CVSweb, AnonCVS and other mirrors. The rest is Copyright © 2002–2022 MirBSD.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report — diffs preferred.

Kontakt / Impressum & Datenschutzerklärung