curs_addstr(3x) curs_addstr(3x)
addstr, addnstr, waddstr, waddnstr, mvaddstr, mvaddnstr,
mvwaddstr, mvwaddnstr - add a string of characters to a
curses window and advance cursor
- curses ウインドウに文字列を追加しカーソルを進める
#include <curses.h>
int addstr(const char *str);
int addnstr(const char *str, int n);
int waddstr(WINDOW *win, const char *str);
int waddnstr(WINDOW *win, const char *str, int n);
int mvaddstr(int y, int x, const char *str);
int mvaddnstr(int y, int x, const char *str, int n);
int mvwaddstr(WINDOW *win, int y, int x, const char *str);
int mvwaddnstr(WINDOW *win, int y, int x, const char *str, int n);
These functions write the (null-terminated) character
string str on the given window. It is similar to calling
waddch once for each character in the string.
これらの関数は str の指す (ヌルで終わる) 文字列を
指定のウインドウに書き込みます。
これは文字列中の各文字に対して waddch を 1 回ずつ呼び出すのと
同じです。
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 characters, or until a terminating null is reached.
If n is -1, then the entire string will be added.
最後の引数に n を取る 4 つの関数は、最大 n 文字、
または終端のヌルに達するまで書き込みます。
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 waddch return an error.
o 内部で呼び出した waddch がエラーを返したとき
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 waddnstr may be macros.
waddnstr 以外のすべてのルーチンはマクロであるかもしれません。
These functions are described in the XSI Curses standard,
Issue 4.
これらの関数は XSI Curses standard, Issue 4 に
記載されています。
curses(3x), curs_addch(3x).
curs_addstr(3x)