EN JA
curs_addwstr(3X)
curs_addwstr(3X) curs_addwstr(3X)

名称

addwstr, addnwstr, waddwstr, waddnwstr, mvaddwstr, mvaddnwstr, mvwaddwstr, mvwaddnwstr - curses ウィンドウにワイド文字列を追加し、カーソルを進める

書式


#include <curses.h>

int addwstr(const wchar_t *wstr);

 


int addnwstr(const wchar_t *wstr, int n);

 


int waddwstr(WINDOW *win, const wchar_t *wstr);

 


int waddnwstr(WINDOW *win, const wchar_t *wstr, int n);

 


int mvaddwstr(int y, int x, const wchar_t *wstr);

 


int mvaddnwstr(int y, int x, const wchar_t *wstr, int n);

 


int mvwaddwstr(WINDOW *win, int y, int x, const wchar_t *wstr);

 


int mvwaddnwstr(WINDOW *win, int y, int x, const wchar_t *wstr, int n);

解説

これらのルーチンは与えられたウィンドウに (ヌルで終了する) wchar_t の文字列 wstr の文字を書き込みます。文字列中の各 wchar_t のために cchar_t を組み立てて、次に、結果の cchar_t のために wadd_wch を呼び出すのと同様です。

mv ルーチンは、任意の文字を書き込む前に、いったんカーソル移動を実行します。その後、カーソルはウィンドウに書き込む副作用として進められます。

最後の引数として n がある 4 つのルーチンは、多くても n wchar_t 文字を書き込みます。 n が -1 であるなら、全体の文字列は、行に合う文字の最大数までか、または終端のヌル文字に到達するまで追加されます。

戻り値

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

waddnwstr を除いて、これらのルーチンのすべては、マクロであるかもしれないことに注意してください。

移植性

これらのすべてのエントリポイントは、XSI Curses 規格、Issue 4 に説明されています。

関連項目

curses(3X), curs_add_wch(3X)