curs_scr_dump(3X) | curs_scr_dump(3X) |
名称
scr_dump, scr_restore, scr_init, scr_set - ファイルから (へ) curses 画面を読み込む (書き込む)書式
#include <curses.h>解説
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 の下で単に述べていますが、"古い"を定義していません。