スポンサーリンク

curs_addchstr

名称
書式
解説
戻り値
注釈
関連項目

名称

addchstr, addchnstr, waddchstr, waddchnstr, mvaddchstr, mvaddchnstr, mvwaddchstr, mvwaddchnstr - キャラクタ(および属性) の ス ト リ ン グ を ncurses ウィンドウに追加する

書式

#include <ncurses.h>

int addchstr(chtype *chstr);
int addchnstr(chtype *chstr, int n);
int waddchstr(WINDOW *win, chtype *chstr);
int waddchnstr(WINDOW *win, chtype *chstr, int n);
int mvaddchstr(int y, int x, chtype *chstr);
int mvaddchnstr(int y, int x, chtype *chstr, int n);
int mvwaddchstr(WINDOW *win, int y, int x, chtype *chstr);
int mvwaddchnstr(WINDOW *win, int y, int x, chtype *chstr, int n);

解説

こ れらのルーチンは、chstr を、ウィンドウイメージ構造内の現在のカーソル 位置およびカーソル位置の後にコピーします。最後の引数として n を持 つ 4 つのルーチンは、多くとも n 個のエレメントをコピーしますが、それより多く は行に入りません。 n=-1 の場合、ストリング全体が、行に入る最大キャラ ク タ数までコピーされます。

ウィ ンドウカーソルは進められません。これらのルーチンは waddnstr より高 速に機能します。しかし、使用するときには注意を払う必要があります。ど ん な種類のチェックもせず (たとえば、改行キャラクタのチェック)、現在のカー ソル位置を進めず、右余白と交差する場合は新しい行にラップアラウンドせ ず にストリングを切り捨てるからです。

戻り値

これらのルーチンはすべて、処理が失敗すると整数 ERR で返ります。処理が成 功して完了すると、ERR 以外の整数値が返されます。ただし、これまでの ルー チンの説明で異なるように注記した場合は別です。

注釈

waddchnstr 以外のルーチンはすべてマクロである可能性があることに注意して ください。

関連項目

ncurses(3)

スポンサーリンク