curs_addstr(3X) | curs_addstr(3X) |
名称
addstr, addnstr, waddstr, waddnstr, mvaddstr, mvaddnstr, mvwaddstr, mvwaddnstr - 文字列を 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);
解説
これらのルーチンは、(ヌル文字で終了する) 文字列 str の文字を与えられたウィンドウに書き込みます。それは、文字列内の文字ごとに 1 回 waddch を呼び出すのに似ています。最後の引数として n がある 4 つのルーチンは、多くても n 文字書き込みます。 n が -1 であるなら、行に適合する文字の最大数までか、または終端のヌル文字に到達するまで、文字列全体が追加されます。戻り値
すべてのルーチンは、失敗すると整数 ERR を返し、成功して終了すれば、 OK (SVr4 マニュアルは、" ERR 以外の整数値"とだけ明記されています) を返します。X/Open は、エラー条件を何も定義していません。この実装は、ウィンドウのポインタが NULL である、または文字列ポインタが NULL である、または waddch への対応する呼び出しがエラーを返すなら、エラーを返します。