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 の指す (ヌルで終わる) 文字列を
       指定のウインドウに書き込みます。
       　これは文字列中の各文字に対して waddch を 1 回ずつ呼び出すのと
       同じです。

       　mv で始まる関数は、文字を書き込む前にいったんカーソルを
       移動します。
       　その後、ウインドウへ書き込む副作用としてカーソルが
       進められます。

       　最後の引数に n を取る 4 つの関数は、最大 n 文字、
       または終端のヌルに達するまで書き込みます。
       　n が -1 ならば、文字列全体を追加します。

戻り値

       　すべての関数は失敗のとき整数 ERR を、成功のとき 
       OK を返します。

       　X/Open はエラーの条件を何も定義していません。
       　この実装では、次の場合にエラーを返します。

       o   ウインドウ・ポインタがヌルのとき

       o   文字列ポインタがヌルのとき

       o   内部で呼び出した waddch がエラーを返したとき

         mv で始まる関数は、最初に wmove を使用してカーソルを移動し、
       位置がウインドウの外だった場合、またはウインドウ・ポインタが
       ヌルの場合にエラーを返します。

注意

       　waddnstr 以外のすべてのルーチンはマクロであるかもしれません。

移植性

       　これらの関数は XSI Curses standard, Issue 4 に
       記載されています。

関連項目

       curses(3x), curs_addch(3x).



                                                        curs_addstr(3x)