EN JA
curs_addstr(3X)
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 への対応する呼び出しがエラーを返すなら、エラーを返します。

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

移植性

これらすべてのエントリポイントは、XSI Curses standard, Issue 4 に記述されています。拡張レベルの適合性に関連した XSI エラー EILSEQ と EOVERFLOW は、まだ検出されていません。

関連項目

curses(3X), curs_addch(3X)