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 であるなら、全体の文字列は、行に合う文字の最大数までか、または終端のヌル文字に到達するまで追加されます。