curses による文字の操作

curses ウィンドウに文字を追加するには、 キーボードまたは curses アプリケーションを使用します。 この項では、curses ウィンドウに現れる文字を追加、除去、 または変更する方法について説明します。

文字サイズ

文字セットによっては、スクリーンに表示される場合に複数のカラムを占有する、 複数カラム文字を定義しています。

宛先ウィンドウの幅より大きい幅の文字を書き出すと、エラーが生じます。

スクリーン・イメージへの文字の追加

curses ライブラリーには、 ウィンドウへのテキストの変更を書き出し、wrefresh サブルーチンに対する次のコール時に更新する必要がある領域をマークする多くのサブルーチンがあります。

waddch サブルーチン

waddch サブルーチンは、指定された文字を使用して、現在の論理カーソル位置にある文字を上書きします。 上書きの後に、 論理カーソルは 1 スペース右に移動します。 waddch サブルーチンを右マージンで呼び出した場合、 これらのサブルーチンは自動改行文字も追加します。 さらに、これらのサブルーチンの 1 つをスクロール領域下部で呼び出したときに、 scrollok サブルーチンが使用可能になっていると、領域は 1 行スクロールアップされます。 例えば、ウィンドウのボトム行で改行を追加すると、ウィンドウは 1 行スクロールアップします。

winch および waddch サブルーチン・ファミリーを一緒に使用することによって、 テキストとビデオの属性を、ある位置から別の位置へコピーすることができます。 winch サブルーチン・ファミリーを使用すれば、 文字およびそのビデオ属性を取り出すことができます。 次に、いずれかの waddch サブルーチンを使用すれば、 文字およびその属性を別の位置に追加することができます。

さらに、waddch サブルーチンを使用すれば、 制御文字をウィンドウに追加することができます。 制御文字は ^X 表記で表示されます。

単一の非制御文字の出力

単一の非制御文字を出力する場合、 wechochar サブルーチンを使用すると、 パフォーマンスをかなり向上させることができます。 これらのサブルーチンは、対応する waddchr サブルーチンへのコールに続く、対応する wrefresh サブルーチンへのコールと機能的に等価です。 wechochar サブルーチンには、wechochar サブルーチン、echochar マクロ、および pechochar サブルーチンなどがあります。

文字セットによっては、非スペーシング文字が入っている場合があります。 (非スペーシング文字は、 wcwidth サブルーチンがゼロの幅を戻す、 ' ¥ 0 '文字を除く文字です。) アプリケーションは、非スペーシング文字をウィンドウに書き出す場合があります。 ウィンドウ内のすべての非スペーシング文字は、 スペーシング文字に関連していて、スペーシング文字を変更します。 ウィンドウ内の非スペーシング文字は個別に扱うことはできません。 非スペーシング文字は、 非スペーシング文字が関連しているスペーシング文字に curses 操作が影響を与える場合は常に、 暗黙的に処理されます。

非スペーシング文字は属性をサポートしません。 幅の広い文字と属性を使用するインターフェースの場合、 幅の広い文字が非スペーシング文字であると、属性は無視されます。 複数カラムの文字は、すべてのカラムの属性からなる 1 つのセットを持っています。 非スペーシング文字とスペーシング文字の関連付けは、 幅の広い文字のインターフェースを使用するアプリケーションによって制御することができます。 幅の広い文字列の関数は、コード・セットに依存する関連付けを提供します。

c と呼ばれるスペーシング文字に関連する非スペーシング文字の、一般的な効果を以下に示します。

• 非スペーシング文字は c の外観を変更する可能性があります。 (例えば、発音区別符号を文字に追加する非スペーシング文字がある可能性があります。) ただし、発音区別符号が組み込まれたスペーシング文字がある場合もあります。
• 非スペーシング文字は c を c に続く文字にブリッジする可能性があります。 この使用法の例は、合字の形成、および複合した表示形式、ワード、 または表意文字への文字の変換です。

スペーシング文字に関連付けられる非スペーシング文字の数が制限されている場合には、 すべての制限は少なくとも 5 以上に制限されます。

複合文字

複合文字は関連する文字のセットであり、 スペーシング文字およびスペーシング文字に関連する非スペーシング文字が入っている可能性があります。 スペーシング複合文字は、1 つのスペーシング文字およびそれに関連する非スペーシング文字 (もしあれば) の入った複合文字です。 複合文字を持っているコード・セットの例は ISO/IEC 10646-1:1993 です。

複合文字はスクリーンに書き出すことができます。 複合文字にスペーシング文字が組み込まれていない場合、すべての非スペーシング文字は、 指定されたスクリーン位置に存在するスペーシング複合文字に関連しています。 アプリケーションがスクリーンから情報を読み戻す場合、 アプリケーションはスペーシング複合文字を獲得します。

cchar_t データ型は、複合文字およびその解釈を表します。 cchar_t が非スペーシング複合文字を表す場合 (すなわち、 複合文字にスペーシング文字がない場合)、その解釈は使用されません。 スクリーンに書き出される場合、 既に表示されているスペーシング文字によって指定される解釈が使用されます。

タイプが cchar_t のオブジェクトは、 setchar サブルーチンを使用して初期化することができ、 その内容は getchar サブルーチンを使用して抽出することができます。 この方法で初期化されなかった cchar_t 値を取る関数の振る舞いは、cchar_t 出力引数を持っている curses 関数から得られます。

特殊文字

関数の中には、 特殊文字を処理するものがあります。 ウィンドウ内の情報に基づいてカーソルを移動しない関数では、 文字列内のこれらの特殊文字だけが使用されて、 以後の文字の位置に影響を与えます。 以下に示したカーソルの移動は、 操作の終了後は可視のカーソルの状態にはなりません。 カーソルを移動しない関数では、これらの特殊文字を使用して、 以後の文字の位置に影響を与え、 物理カーソルの移動を行うことができます。

制御文字

特殊文字の処理を実行する curses 関数は、概念上、 制御文字を ( ' ^ ' ) 文字とそれに続く 2 番目の文字 (英字の場合には大文字) に変換し、 制御文字の代わりに、この文字列をウィンドウに書き出します。 ウィンドウからテキストを取り出す関数は、元の制御文字を取り出しません。

線画グラフィックス:

waddch サブルーチンによってスクリーンに線画文字を追加するために、 以下の変数を使用することができます。 変数は、端末用に定義されている場合、 A_ALTCHARSET ビットがオンになります。 それ以外の場合、以下の表にリストされているデフォルト文字が変数に保管されます。

waddstr サブルーチン

winsch サブルーチン

winsch サブルーチンは、ウィンドウ内の現在の文字の前に指定された文字を挿入します。 挿入文字の右側のすべての文字は、1 スペース右側に移動します。 結果として、行上の右端の文字が脱落する可能性があります。 論理カーソルと物理カーソルの位置は、移動後も変更されません。 winsch サブルーチンには以下のものが含まれます。

winsertln サブルーチン

winsertln サブルーチンは、 ウィンドウ内の現在行の上にブランク行を挿入します。 insertln サブルーチンは stdscr に 1 行を挿入します。 ウィンドウのボトム行は脱落します。 winsertln サブルーチンは、ユーザー定義ウィンドウでも同じアクションを実行します。

wprintw サブルーチン

wprintw サブルーチンは、 一連の文字 (現在の文字から始まる) をフォーマット設定された出力で置換します。 フォーマットは printf コマンドの場合と同じです。 printw ファミリーは以下のものから構成されます。

wprintw サブルーチンは、waddch サブルーチンを呼び出して文字を置換します。

unctrl マクロ

unctrl マクロは、^X 表記で指定された制御文字の印刷可能な表現を戻します。 unctrl マクロは、印刷文字を現状のまま戻します。

テキスト・スクロールの使用可能化

プログラムまたはユーザーがカーソルをウィンドウのボトムの端より先に移動した場合に、 スクロールが発生します。 スクロールを発生させるには、 最初に scrollok サブルーチンを使用して、 ウィンドウのスクロールを使用可能にする必要があります。 ウィンドウがスクロールするのは、 スクロールが使用可能であり、かつ、以下のいずれかの条件が発生した場合です。

• カーソルがウィンドウの端より先へ移動する場合。
• 改行文字が最後の行で検出された場合。
• 文字が最後の行の最後の位置に挿入された場合。

ウィンドウをスクロールするとき、curses はウィンドウとディスプレイの両方を更新します。 ただし、端末上で物理的なスクロール効果を得るには、Flag パラメーターを TRUE に設定して、idlok サブルーチンを呼び出す必要があります。

スクロールが使用不可の場合、カーソルは、 ボトム行上の文字が入力された位置に留まります。

ウィンドウのスクロールが使用可能な場合、setscrreg サブルーチンを使用して、 ウィンドウ内にソフトウェア・スクロール領域を作成することができます。 領域のトップ行とボトム行を示す値を setscrreg サブルーチンに渡します。 この領域に関して setscrreg が使用可能であり、 ウィンドウのスクロールが使用可能である場合、指定されたボトム行の先へ移動する試みによって、 領域内のすべての行が 1 行上へスクロールします。 setscrreg マクロを使用すれば、stdscr 内にスクロール領域を定義することができます。 あるいは、wsetscrreg サブルーチンを使用すれば、ユーザー定義ウィンドウ内にスクロール領域を定義することができます。

文字の削除

テキストを削除するには、テキストをブランク・スペースで置換するか、 または文字を文字配列から除去し、その行上の残りの文字を 1 スペース左へ移動します。

werase サブルーチン

erase マクロは、ブランク・スペースを stdscr 内のすべての位置にコピーします。 werase サブルーチンはブランク・スペースをユーザー定義ウィンドウ内のすべての位置に置きます。 ウィンドウ内の単一文字を削除するには、wdelch サブルーチンを使用してください。

wclear サブルーチン

wclear サブルーチン は werase サブルーチンと似ています。 ただし、wclear サブルーチンは、 ウィンドウのすべての位置にブランク・スペースを置くだけでなく、wclearok サブルーチンも呼び出します。 結果として、画面は、次回の wrefresh サブルーチンの呼び出しでクリアされます。

wclear サブルーチン・ファミリーには、wclear サブルーチン、clear マクロ、および clearok サブルーチンが入っています。 clear マクロは stdscr 内のすべての位置にブランクを置きます。

wclrtoeol サブルーチン

clrtoeol マクロは stdscr 内で作動し、wclrtoeol サブルーチンは同じアクションをユーザー定義ウィンドウ内で実行します。

wclrtobot サブルーチン

clrtobot マクロは stdscr 内で作動し、 wclrtobot は同じアクションをユーザー定義ウィンドウ内で実行します。

wdelch サブルーチン

wdelch サブルーチンは現在の文字を削除し、現在行の現在の文字の右側にあるすべての文字を、 1 桁左に移動します。 行の最後の文字はブランクで埋められます。 delch サブルーチン・ファミリーは以下のサブルーチンとマクロから構成されます。

wdeleteln サブルーチン

deleteln サブルーチンは現在行を削除し、 現在行の下にあるすべての行を 1 行上に移動します。 このアクションによって、ウィンドウのボトム行はクリアされます。

文字の獲得

プログラムはキーボードまたはディスプレイから文字を取り出すことができます。 wgetch サブルーチンはキーボードから文字を取り出します。 winch サブルーチンはディスプレイから文字を取り出します。

wgetch サブルーチン

wgetch サブルーチンは、 ウィンドウに関連する端末に接続されているキーボードから文字を読み取ります。 ウィンドウ内の何かが変更されている場合、例えば、カーソルが移動されたか、 またはテキストが変更されている場合、文字を獲得する前に、 これらのサブルーチンは、wrefresh サブルーチンを呼び出します。

wgetch サブルーチン・ファミリーは以下のものから構成されます。

wgetch サブルーチンへのコールによって以前に獲得した文字を入力キューに置くには、ungetch サブルーチンを使用します。 文字は、wgetch サブルーチンへの次のコールによって取り出されます。

端末のモード

wgetch サブルーチンの出力は、部分的には、 端末のモードによって決定されます。 以下のリストは、 端末モードのタイプ別に、wgetch サブルーチンのアクションを示しています。

ファンクション・キー

ファンクション・キーが curses.h ファイルに定義されています。 キーパッドが使用可能であれば、wgetch サブルーチンによってファンクション・キーを戻すことができます。 端末によっては、ファンクション・キーのすべてはサポートしない場合があります。 端末が特定のキーをサポートするかどうかを調べるには、 その terminfo データベース定義を検査します。

ファンクション・キーの取得

プログラムが keypad サブルーチンを使用してキーボードを使用可能にし、 ユーザーがファンクション・キーを押すと、 そのファンクション・キーのトークンが元の文字の代わりに戻されます。 使用可能なファンクション・キーは、 /usr/include/curses.h ファイルで定義されています。 各定義ステートメントは、KEY_ 接頭部で始まり、 キーは値 03510 で始まる整数として定義されています。

ファンクション・キーの先頭である可能性がある文字 (エスケープ文字など) が受信されると、curses はタイマー (/usr/include/sys/time.h に定義されているタイプ timeval の構造体) を設定します。 タイマーが期限切れになる前に、シーケンスの残りの部分が受信されない場合、 その文字はパススルーされます。 それ以外の場合、ファンクション・キーの値が戻されます。 この理由のため、ユーザーが Esc キーを押した後に、 エスケープがプログラムに戻る前に遅延が生じます。 したがって、wgetch サブルーチンなどの単一文字サブルーチンを呼び出す場合、 できるだけ Esc キーの使用を回避します。 このタイマーは、ESCDELAY 環境変数を使用して、 指定変更または拡張することができます。

ESCDELAY 環境変数は、タイムアウトになって、ESC キー・ストロークを、 バッファー内の他の文字と結合してキー・シーケンスを作成するのではなく、 エスケープ文字として処理する前に待つ時間の長さを設定します。 ESCDELAY 値はミリ秒の 5 分の 1 単位で測定されます。 ESCDELAY 変数が 0 の場合、システムは、 バッファーからの情報を待たずに、エスケープ応答をすぐに組み立てます。 0 から 99,999 の任意の値を選択することができます。 ESCDELAY 変数のデフォルト設定値は 500 (1/10 秒) です。

wgetch サブルーチンがタイマーを設定するのを防ぐには、notimeout サブルーチンを呼び出します。 notimeout を TRUE に設定すると、curses はデータの取り出し時に、 ファンクション・キーと文字を区別しません。

keyname サブルーチン

keyname サブルーチンは、Key 引数のシンボル名を含んでいる文字列を指すポインターを戻します。 Key 引数として、wgetch、getch、 mvgetch、 または mvwgetch サブルーチンから戻される任意のキーを指定することができます。

winch サブルーチン

winch サブルーチンは現在位置の文字を取り出します。 その位置に属性が設定されている場合、 属性値と論理 OR された値が戻されます。 winch サブルーチンを使用すれば、文字だけ、またはその属性だけを抽出することができます。 このためには、定義済み定数 A_CHARTEXT と A_ATTRIBUTES を論理 & (アンパーサンド) 演算子とともに使用します。 これらの定数は curses.h ファイルに定義されています。 winch サブルーチンを以下に示します。

wscanw サブルーチン

wscanw サブルーチンは文字データを読み、変換仕様に従って解釈し、変換結果をメモリーに保管します。 wscanw サブルーチンは wgetstr サブルーチンを使用して、文字データを読みます。 wscanw サブルーチンを以下に示します。