[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions , Volume 2


scr_restore Subroutine

Purpose

Restores the virtual screen from a dump file.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>


scr_restore( FileName)
char *FileName;

Description

The scr_restore subroutine restores the virtual screen from the contents of a dump file. You create a dump file with the scr_dump subroutine. To update the terminal's display with the restored virtual screen, call the wrefresh or doupdate subroutine after restoring from a dump file.

To communicate the screen image across processes, use the scr_restore subroutine along with the scr_dump subroutine.

Return Values


ERR Indicates the content of the dump file is incompatible with the current release of curses.
OK Indicates that the virtual screen was successfully restored from a dump file.

Parameters


FileName Identifies the name of the dump file.

Example

To restore the contents of the virtual screen from the /tmp/virtual.dump file and update the terminal screen, use:

scr_restore("/tmp/virtual.dump");
doupdate();

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The scr_dump (scr_dump, scr_init, scr_restore, scr_set Subroutine) subroutine, scr_init (scr_init Subroutine) subroutine.

Curses Overview for Programming, List of Curses Subroutines, Understanding Terminals with Curses, Manipulating Video Attributes in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]