curs_addwstr(3x) curs_addwstr(3x)
addwstr, addnwstr, waddwstr, waddnwstr, mvaddwstr,
mvaddnwstr, mvwaddwstr, mvwaddnwstr - add a string of wide
characters to a curses window and advance cursor
- 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);
These functions write the characters of the (null-termi-
nated) wchar_t character string wstr on the given window.
It is similar to constructing a cchar_t for each wchar_t
in the string, then calling wadd_wch for the resulting
cchar_t.
これらの関数は wstr の指す (ヌルで終わる) wchar_t 型
ワイド文字列を指定のウインドウに書き込みます。
これは文字列中の各 wchar_t 値から cchar_t 値を作り、
その cchar_t 値に対して wadd_wch を呼び出すのと同じです。
The mv functions perform cursor movement once, before
writing any characters. Thereafter, the cursor is ad-
vanced as a side-effect of writing to the window.
mv で始まる関数は、文字を書き込む前にいったんカーソルを
移動します。
その後、ウインドウへ書き込む副作用としてカーソルが
進められます。
The four functions with n as the last argument write at
most n wchar_t characters, or until a terminating null is
reached. If n is -1, then the entire string will be
added.
最後の引数に n を取る 4 つの関数は、最大 n 個の
wchar_t 型ワイド文字を、または終端のヌルに達するまで
書き込みます。
n が -1 ならば、文字列全体を追加します。
All functions return the integer ERR upon failure and OK
on success.
すべての関数は失敗のとき整数 ERR を、成功のとき
OK を返します。
X/Open does not define any error conditions. This imple-
mentation returns an error
X/Open はエラーの条件を何も定義していません。
この実装では、次の場合にエラーを返します。
o if the window pointer is null or
o ウインドウ・ポインタがヌルのとき
o if the string pointer is null or
o 文字列ポインタがヌルのとき
o if the corresponding calls to wadd_wch return an er-
ror.
o 内部で呼び出した wadd_wch がエラーを返したとき
Functions with a "mv" prefix first perform a cursor move-
ment using wmove, and return an error if the position is
outside the window, or if the window pointer is null.
mv で始まる関数は、最初に wmove を使用してカーソルを移動し、
位置がウインドウの外だった場合、またはウインドウ・ポインタが
ヌルの場合にエラーを返します。
All of these functions except waddnwstr may be macros.
waddnwstr 以外のすべてのルーチンはマクロであるかもしれません。
These functions are described in the XSI Curses standard,
Issue 4.
これらの関数は XSI Curses standard, Issue 4 に
記載されています。
curses(3x), curs_add_wch(3x)
curs_addwstr(3x)