curs_add_wchstr(3x) curs_add_wchstr(3x)
add_wchstr, add_wchnstr, wadd_wchstr, wadd_wchnstr,
mvadd_wchstr, mvadd_wchnstr, mvwadd_wchstr, mvwadd_wchnstr
- add an array of complex characters (and attributes) to a
curses window
- curses ウインドウに複合文字 (と属性) の配列を追加する
#include <curses.h>
int add_wchstr(const cchar_t *wchstr);
int add_wchnstr(const cchar_t *wchstr, int n);
int wadd_wchstr(WINDOW * win, const cchar_t *wchstr);
int wadd_wchnstr(WINDOW * win, const cchar_t *wchstr, int n);
int mvadd_wchstr(int y, int x, const cchar_t *wchstr);
int mvadd_wchnstr(int y, int x, const cchar_t *wchstr, int n);
int mvwadd_wchstr(WINDOW *win, int y, int x, const cchar_t *wchstr);
int mvwadd_wchnstr(WINDOW *win, int y, int x, const cchar_t *wchstr, int n);
These functions copy the (null-terminated) array of com-
plex characters wchstr into the window image structure
starting at the current cursor position. The four func-
tions with n as the last argument 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.
これらの関数は wchstr の指す (ヌルで終わる) 複合文字の配列を
ウインドウのイメージ構造に現在のカーソル位置からコピーします。
最後の引数に 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 右端 (マージン) に達した場合、新しい行に折り返さず、
文字列を切り詰めます。
These functions end successfully on encountering a null
cchar_t, or when they have filled the current line. If a
complex character cannot completely fit at the end of the
current line, the remaining columns are filled with the
background character and rendition.
これらの関数は cchar_t 型のヌルに出会うか、または現在の行を
埋めつくすと正常に終了します。
複合文字が現在行の終わりにちょうど収まらない場合、残りの桁は
背景文字と背景属性で埋められます。
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 wadd_wchnstr may be macros.
wadd_wchnstr 以外のすべてのルーチンはマクロであるかも
しれません。
These entry points are described in the XSI Curses stan-
dard, Issue 4.
これらのルーチンは XSI Curses standard, Issue 4 に
記載されています。
curs_addwstr(3x), curses(3x).
Comparable functions in the narrow-character (ncurses) li-
brary are described in curs_addchstr(3x).
1 バイト文字用ライブラリ (ncurses) で対応する関数群は
curs_addchstr(3x) で説明しています。
curs_add_wchstr(3x)