fc733ebccd
This section is based on catpages contributed by Mainichi Communications, Inc. Translated by: MYCOM team Converted by: Japanese Online Manual Project <man-jp@jp.FreeBSD.ORG> Submitted by: Kazuo Horikawa <k-horik@yk.rim.or.jp>
45 lines
1.7 KiB
Groff
45 lines
1.7 KiB
Groff
.TH curs_addchstr 3 ""
|
|
.SH 名称
|
|
\fBaddchstr\fR, \fBaddchnstr\fR, \fBwaddchstr\fR,
|
|
\fBwaddchnstr\fR, \fBmvaddchstr\fR, \fBmvaddchnstr\fR, \fBmvwaddchstr\fR,
|
|
\fBmvwaddchnstr\fR - キャラクタ(および属性)のストリングを \fBncurses\fR ウィンドウに追加する
|
|
.SH 書式
|
|
\fB#include <ncurses.h>\fR
|
|
|
|
\fBint addchstr(chtype *chstr);\fR
|
|
.br
|
|
\fBint addchnstr(chtype *chstr, int n);\fR
|
|
.br
|
|
\fBint waddchstr(WINDOW *win, chtype *chstr);\fR
|
|
.br
|
|
\fBint waddchnstr(WINDOW *win, chtype *chstr, int n);\fR
|
|
.br
|
|
\fBint mvaddchstr(int y, int x, chtype *chstr);\fR
|
|
.br
|
|
\fBint mvaddchnstr(int y, int x, chtype *chstr, int n);\fR
|
|
.br
|
|
\fBint mvwaddchstr(WINDOW *win, int y, int x, chtype *chstr);\fR
|
|
.br
|
|
\fBint mvwaddchnstr(WINDOW *win, int y, int x, chtype *chstr, int n);\fR
|
|
.SH 解説
|
|
これらのルーチンは、\fIchstr\fR を、ウィンドウイメージ構造内の現在の
|
|
カーソル位置およびカーソル位置の後にコピーします。最後の引数として
|
|
\fIn\fR を持つ 4 つのルーチンは、多くとも \fIn\fR
|
|
個のエレメントをコピーしますが、それより多くは行に入りません。
|
|
\fBn\fR=\fB-1\fR の場合、ストリング全体が、行に入る最大
|
|
キャラクタ数までコピーされます。
|
|
|
|
ウィンドウカーソルは進められません。これらのルーチンは \fBwaddnstr\fR
|
|
より高速に機能します。しかし、使用するときには注意を払う必要があります。
|
|
どんな種類のチェックもせず (たとえば、改行キャラクタのチェック)、
|
|
現在のカーソル位置を進めず、右余白と交差する場合は新しい行に
|
|
ラップアラウンドせずにストリングを切り捨てるからです。
|
|
.SH 戻り値
|
|
これらのルーチンはすべて、処理が失敗すると整数 \fBERR\fR で返ります。
|
|
処理が成功して完了すると、\fBERR\fR 以外の整数値が返されます。
|
|
ただし、これまでのルーチンの説明で異なるように注記した場合は別です。
|
|
.SH 注釈
|
|
\fBwaddchnstr\fR 以外のルーチンはすべてマクロである可能性があることに
|
|
注意してください。
|
|
.SH 関連項目
|
|
\fBncurses\fR(3)
|