名称

scr_dump, scr_restore, scr_init, scr_set - ファイルから (へ) curses 画面を読み込む (書き込む)

書式

#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);

解説

scr_dump ルーチンは、仮想画面の現在の内容をファイル filename にダンプします。

scr_restore ルーチンは、 scr_dump を使用して書き込まなければならない、 filename の内容に仮想画面を設定します。 doupdate への次の呼び出しは、それがダンプファイルの中に見られる状態に画面を復旧します。

scr_init ルーチンは、 filename の内容を読み込み、端末が現在その画面上にあるものに関する curses データ構造を初期化するためにそれらを使用します。データが有効であると決定されたなら、 curses は、画面をクリアし最初から始めるのではなく、この情報に基づいて画面の次の更新を行ないます。 scr_init は、その endwin 呼び出しの後に、 scr_dump を行った別のプロセスと画面を共有するために initscr または system 呼び出しの後に使用されます。 terminfo ケーパビリティ rmcup と nrrmc が存在するなら、また、端末が前の scr_dump 呼び出し以後に書き込まれたなら、データは、無効と宣言されます。

scr_set ルーチンは、 scr_restore と scr_init を組み合わせたものです。それは、 filename の情報が画面上に現在あるものと、また、プログラムが画面上で望むものをプログラムに伝えます。これを画面継承関数と見なすことができます。

ファイルから (へ) ウィンドウを読み込む (書き込む) ためには、 getwin と putwin のルーチンを使用します [ curs_util(3X) を参照]。

戻り値

すべてのルーチンは、失敗すると整数 ERR を返し、成功すれば OK を返します。

X/Open は、エラー条件を何も定義していません。この実装で、それぞれのルーチンは、ファイルをオープンすることができないなら、エラーを返します。

注

scr_init、 scr_set と scr_restore は、マクロであるかもしれないことに注意してください。

移植性

XSI Curses standard, Issue 4 は、(const 修飾子を加えて) これらの関数を記述しています。

SVr4 文書は、"tty のタイムスタンプが古いなら"ダンプデータも無効であると見なされると、 scr_init の下で単に述べていますが、"古い"を定義していません。

関連項目

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