scr_dump(3X)                                                   scr_dump(3X)

NAME
     scrdump, scrinit, scrrestore, scrset - Ein-/Ausgabefunktionen für
     den Bildschirminhalt

SYNTAX
     cc [flag ...] file ... -lcurses [library ...]

     #include <curses.h>

     int scrdump(const char *filename);

     int scrinit(const char *filename);

     int scrrestore(const char *filename);

     int scrset(const char *filename);

BESCHREIBUNG
     Die Funktion scrdump() schreibt den aktuellen Inhalt des virtuellen
     Bildschirms in die Datei, die durch filename in einem nicht festgeleg-
     ten Format angegeben ist.

     Die Funktion scrrestore() setzt den virtuellen Bildschirm auf den
     Inhalt der durch filename angegebenen Datei zurück. Diese Datei muß
     mit der Funktion scrdump() geschrieben worden sein. Bei der nächsten
     Aktualisierung wird der Bildschirm auf den Inhalt zurückgesetzt, der
     in der Speicherabzugsdatei gespeichert ist.

     Die Funktion scrinit() liest den Inhalt der durch filename angegebe-
     nen Datei und verwendet ihn, um die Curses-Datenstrukturen mit den
     aktuellen, auf dem Terminalbildschirm angezeigten Daten zu initiali-
     sieren. Die nächste Aktualisierung erfolgt basierend auf diesen Infor-
     mationen, sofern nicht eine der folgenden Bedingungen vorliegt:

     -  Auf das Terminal wurden Daten geschrieben, nachdem ein Speicherab-
        zug des virtuellen Bildschirms in der Datei filename erstellt
        wurde.

     -  Die terminfo-Eigenschaften rmcup und nrrmc sind für das aktuelle
        Terminal definiert.

     Die Funktion scrset() ist eine Kombination aus scrrestore() und
     scrinit(). Sie teilt dem Programm mit, daß die Daten in der über
     filename angegebenen Datei dem aktuellen Inhalt des Bildschirms ent-
     sprechen und gibt ferner an, was laut Programm auf dem Bildschirm
     angezeigt werden soll. Dies kann man sich auch als eine Funktion zur
     Übernahme des Bildschirminhalts vorstellen.

RÜCKGABEWERT
     Nach erfolgreicher Ausführung geben diese Funktionen den Wert OK
     zurück. Andernfalls wird ERR zurückgegeben.




Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

scr_dump(3X)                                                   scr_dump(3X)

FEHLER
     Es sind keine Fehlerzuordnungen definiert.

HINWEISE
     Die Funktion scrinit() wird nach initscr() oder nach einem system()-
     Aufruf verwendet, um den Bildschirm gemeinsam mit einem anderen Prozeß
     zu benutzen, der über die Funktion scrdump() einen Speicherabzug des
     Bildschirminhalts nach dem Aufruf von endwin() ausgeführt hat.

     Um den Inhalt eines Fensters aus einer Datei zu lesen, muß getwin()
     aufgerufen werden; um den Inhalt eines Fensters in eine Datei zu
     schreiben, muß putwin() aufgerufen werden.

SIEHE AUCH
     open(2), read(2), write(2), curses(3X), delscreen(3X), doupdate(3X),
     endwin(3X), getwin(3X), terminfo(4), curses(5).






































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98