cb5d1a9147
jpman project specific RCS keyword (jpman %Id) is obsolete, after manual entries are stored in freefall CVS repository. This old Id is useless and more worse it confuses users and bug reporters. So, this old Id is removed. Submitted by:jpman project <man-jp@jp.FreeBSD.org>
46 lines
1.7 KiB
Groff
46 lines
1.7 KiB
Groff
.\" $FreeBSD$
|
|
.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)
|