curs_addchstr(3x) curs_addchstr(3x)
addchstr, addchnstr, waddchstr, waddchnstr, mvaddchstr,
mvaddchnstr, mvwaddchstr, mvwaddchnstr - add a string of
characters (and attributes) to a curses window
- curses ウインドウに文字列 (と属性) を追加する
#include <curses.h>
int addchstr(const chtype *chstr);
int addchnstr(const chtype *chstr, int n);
int waddchstr(WINDOW *win, const chtype *chstr);
int waddchnstr(WINDOW *win, const chtype *chstr, int n);
int mvaddchstr(int y, int x, const chtype *chstr);
int mvaddchnstr(int y, int x, const chtype *chstr, int n);
int mvwaddchstr(WINDOW *win, int y, int x, const chtype *chstr);
int mvwaddchnstr(WINDOW *win, int y, int x, const chtype *chstr, int n);
These functions copy the (null-terminated) chstr array in-
to the window image structure starting at the current cur-
sor position. The four functions with n as the last argu-
ment copy at most n elements, but no more than will fit on
the line. If n=-1 then the whole array is copied, to the
maximum number of characters that will fit on the line.
これらの関数は chstr の指す (ヌルで終わる) 配列を
ウインドウのイメージ構造に現在のカーソル位置からコピーします。
最後の引数に n を取る 4 つの関数は、行に収まる限り、
最大 n 要素をコピーします。
n=-1 ならば配列全体をコピーします。文字の最大数は行に
収まるだけとなります。
The window cursor is not advanced. These functions work
faster than waddnstr. On the other hand:
ウインドウのカーソルは進みません。
これらの関数は waddnstr より速く動作します。
その一方
o they do not perform checking (such as for the newline,
backspace, or carriage return characters),
o (改行、バックスペース、復帰文字のような)
チェックをしません。
o they do not advance the current cursor position,
o 現在のカーソル位置を進めません。
o they do not expand other control characters to ^-es-
capes, and
o その他の制御文字を ^ 表現に展開しません。
o they truncate the string if it crosses the right mar-
gin, rather than wrapping it around to the new line.
o 右端 (マージン) に達した場合、新しい行に折り返さず、
文字列を切り詰めます。
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 if the window pointer is null.
X/Open はエラーの条件を何も定義していません。
この実装では、ウインドウ・ポインタがヌルのときエラーを
返します。
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 functions except waddchnstr may be macros.
waddchnstr 以外のすべてのルーチンはマクロであるかも
しれません。
These entry points are described in the XSI Curses stan-
dard, Issue 4.
これらのルーチンは XSI Curses standard, Issue 4 に
記載されています。
curs_addstr(3x), curses(3x).
Comparable functions in the wide-character (ncursesw) li-
brary are described in curs_add_wchstr(3x).
ワイド文字用ライブラリ (ncursesw) で対応する関数群は
curs_add_wchstr(3x) で説明しています。
curs_addchstr(3x)