curs_add_wchstr(3X) | curs_add_wchstr(3X) |
名称
add_wchstr, add_wchnstr, wadd_wchstr, wadd_wchnstr, mvadd_wchstr, mvadd_wchnstr, mvwadd_wchstr, mvwadd_wchnstr - curses ウィンドウに複合文字の配列 (と属性) を追加します書式
#include <curses.h>
int add_wchstr(const cchar_t *wchstr);
int add_wchnstr(const cchar_t *wchstr, int n);
int wadd_wchstr(WINDOW * win, const cchar_t *wchstr);
int wadd_wchnstr(WINDOW * win, const cchar_t *wchstr, int n);
int mvadd_wchstr(int y, int x, const cchar_t *wchstr);
int mvadd_wchnstr(int y, int x, const cchar_t *wchstr, int n);
int mvwadd_wchstr(WINDOW *win, int y, int x, const cchar_t *wchstr);
int mvwadd_wchnstr(WINDOW *win, int y, int x, const cchar_t *wchstr, int n);
解説
これらのルーチンは、現在のカーソル位置の後のウィンドウイメージ構造に複合文字の配列 wchstr をコピーします。最後の引数としての n がある 4 つのルーチンは、多くても n 個の要素をコピーしますが、行に合うまでです。 n= -1 であるなら、全体の配列は、行に合う文字の最大数までコピーされます。ウィンドウのカーソルは進められ ません。これらのルーチンは、 waddnstr より速く動作します。他方では、それらは、(改行、バックスペースまたは復帰改行文字のような) チェックを実行しないで、現在のカーソル位置を進めないで、他の制御文字を ^-escapes に拡張しないで、右マージンに交差するなら改行を折り返さないで、切り捨てます。
これらのルーチンは、ヌルの cchar_t に出会うか、または現在行が満たされたとき、成功して終わります。複合文字が現在行の終りに完全に適合できないなら、残っているカラムはバックグラウンド文字と表現 (rendition) で満たされます。