curs_in_wchstr(3x) curs_in_wchstr(3x)
in_wchstr, in_wchnstr, win_wchstr, win_wchnstr, mvin_wchstr, mvin_wchnstr, mvwin_wchstr, mvwin_wchnstr - get an array of complex characters and renditions from a curses window - curses ウインドウから複合文字と表示属性の配列を取得する
#include <curses.h> int in_wchstr(cchar_t *wchstr); int in_wchnstr(cchar_t *wchstr, int n); int win_wchstr(WINDOW *win, cchar_t *wchstr); int win_wchnstr(WINDOW *win, cchar_t *wchstr, int n); int mvin_wchstr(int y, int x, cchar_t *wchstr); int mvin_wchnstr(int y, int x, cchar_t *wchstr, int n); int mvwin_wchstr(WINDOW *win, int y, int x, cchar_t *wchstr); int mvwin_wchnstr(WINDOW *win, int y, int x, cchar_t *wchstr, int n);
These functions return an array of complex characters in wchstr, starting at the current cursor position in the named window. Attributes (rendition) are stored with the characters. これらの関数は、指定のウインドウのカーソルの現在位置から 始まる複合文字の配列を wchstr の中に与えます。 表示属性は文字と一緒に格納されます。 The in_wchnstr, mvin_wchnstr, mvwin_wchnstr and win_wchn- str fill the array with at most n cchar_t elements. in_wchnstr, mvin_wchnstr, mvwin_wchnstr, win_wchnstr は cchar_t 型配列を最大 n 要素まで満たします。
Note that all routines except win_wchnstr may be macros. win_wchnstr 以外のすべてのルーチンはマクロであるかもしれない ことに注意してください。 Reading a line that overflows the array pointed to by wch- str with in_wchstr, mvin_wchstr, mvwin_wchstr or win_wch- str causes undefined results. Therefore, the use of in_wchnstr, mvin_wchnstr, mvwin_wchnstr, or win_wchnstr is recommended. in_wchstr, mvin_wchstr, mvwin_wchstr, win_wchnstr で wchstr の指す配列がオーバーフローするような行を読むと、 未定義の結果を引き起こします。 したがって、in_wchnstr, mvin_wchnstr, mvwin_wchnstr, win_wchnstr の使用を推奨します。
Upon successful completion, these functions return OK. Otherwise, they return ERR. これらの関数は正常終了のとき OK を、それ以外のとき ERR を 返します。 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 を使用してカーソルを移動し、 位置がウインドウの外だった場合、またはウインドウ・ポインタが ヌルの場合にエラーを返します。
The XSI Curses defines no error conditions. This imple- mentation checks for null pointers, returning ERR in that case. XSI Curses はエラーの条件を何も定義していません。 この実装はヌルポインタをチェックし、その場合は ERR を 返します。
Functions: curses(3x), curs_in_wch(3x), curs_instr(3x), curs_inwstr(3x) curs_inchstr(3x) curs_in_wchstr(3x)