Curses Library Functions                   cursscrdump(3CURSES)



NAME
     cursscrdump, scrdump, scrrestore,  scrinit,  scrset  -
     read or write a curses screen from or to a file

SYNOPSIS
     cc [ flag ... ] file ... -lcurses [ library ... ]
     #include 

     int scrdump(char *filename);


     int scrrestore(char *filename);


     int scrinit(char *filename);


     int scrset(char *filename);


DESCRIPTION
     With the scrdump() routine, the  current  contents  of  the
     virtual screen are written to the file filename.


     With the scrrestore() routine, the virtual screen is set to
     the contents of filename, which must have been written using
     scrdump(). The next call to doupdate() restores the  screen
     to the way it looked in the dump file.


     With the scrinit() routine, the contents  of  filename  are
     read  in  and  used 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. scrinit() is used after
     initscr() or a system(3C) call  to  share  the  screen  with
     another  process  which  has  done  a  scrdump()  after its
     endwin() call. The data is declared  invalid  if  the  time-
     stamp of the tty is old or the terminfo capabilities rmcup()
     and nrrmc() exist.


     The scrset() routine is a combination of scrrestore()  and
     scrinit().  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.






SunOS 5.11          Last change: 31 Dec 1996                    1






Curses Library Functions                   cursscrdump(3CURSES)



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

RETURN VALUES
     All routines return the integer ER upon failure and OK upon
     success.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     cursinitscr(3CURSES),                cursrefresh(3CURSES),
     cursutil(3CURSES),   curses(3CURSES),   system(3C),  attri-
     butes(5)

NOTES
     The header   automatically  includes  the  headers
      and .


     Note that scrinit(), scrset(), and  scrrestore()  may  be
     macros.























SunOS 5.11          Last change: 31 Dec 1996                    2