EN JA
curs_add_wchstr(3X)
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) で満たされます。

wadd_wchnstr を除いて、すべての関数は、マクロであるかもしれないことに注意してください。

戻り値

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

移植性

これらのすべての関数は、XSI Curses 規格、Issue 4 に説明されています。

関連項目

curses(3X), curs_addchstr(3X), curs_addwstr(3X)