SCR_DUMP(3XCURSES)SCR_DUMP(3XCURSES)NAME
scr_dump, scr_init, scr_restore, scr_set - write screen contents
to/from a file
SYNOPSIS
cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib \
-R /usr/xpg4/lib -lcurses [ library... ]
c89 [ flag... ] file... -lcurses [ library... ]
#include <curses.h>
int scr_dump(const char *filename);
int scr_init(const char *filename);
int scr_restore(const char *filename);
int scr_set(const char *filename);
PARAMETERS
filename
Is a pointer to the file in which screen contents are writ‐
ten.
DESCRIPTION
These function perform input/output functions on a screen basis.
The scr_dump() function writes the contents of the virtual screen,
curscr, to filename.
The scr_restore() function reads the contents of filename from curscr
(which must have been written with scr_dump()). The next refresh oper‐
ation restores the screen to the way it looks in filename.
The scr_init() function reads the contents of filename and uses those
contents to initialize the X/Open Curses data structures to what is
actually on screen. The next refresh operation bases its updates on
this data, unless the terminal has been written to since filename was
saved or the terminfo capabilities rmcup and nrrmc are defined for the
current terminal.
The scr_set() function combines scr_restore() and scr_init(). It
informs the program that the contents of the file filename are what is
currently on the screen and that the program wants those contents on
the screen.
RETURN VALUES
On success, these functions return OK. Otherwise, they return ERR.
ERRORS
None.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌────────────────────┬─────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼─────────────────┤
│Interface Stability │ Standard │
├────────────────────┼─────────────────┤
│MT-Level │ Unsafe │
└────────────────────┴─────────────────┘
SEE ALSOdelscreen(3XCURSES), doupdate(3XCURSES), endwin(3XCURSES),
getwin(3XCURSES), libcurses(3XCURSES), attributes(5), standards(5)
Jun 5, 2002 SCR_DUMP(3XCURSES)
