curs_printw(3X) |
|
curs_printw(3X) |
名称
printw,
wprintw,
mvprintw,
mvwprintw,
vwprintw,
vw_printw -
curses ウィンドウに書式化した出力を印刷 (表示) する
書式
#include <curses.h>
int printw(const char *fmt, ...);
int wprintw(WINDOW *win, const char *fmt, ...);
int mvprintw(int y, int x, const char *fmt, ...);
int mvwprintw(WINDOW *win, int y, int x, const char *fmt, ...);
int vwprintw(WINDOW *win, const char *fmt, va_list varglist);
int vw_printw(WINDOW *win, const char *fmt, va_list varglist);
解説
printw、
wprintw、
mvprintw と
mvwprintw ルーチンは、
printf [
printf(3) を参照] と類似しています。実際に、
printf によって出力される文字列は、あたかも
waddstr が与えられたウィンドウで使用されたかのように代わりに出力されます。
vwprintw と wv_printw ルーチンは、 vprintf [ printf(3) を参照] と類似しており、可変長引数リストを使用して wprintw を実行します。 3 番目の引数は、 <stdarg.h> で定義されている、引数のリストを指すポインタである、 va_list です。
戻り値
整数を返すルーチンは、失敗すると
ERR を返し、成功して終了すれば、
OK (SVr4 は、"
ERR 以外の整数値"とだけ明記されています) を返します。
X/Open は、エラー条件を何も定義していません。この実装では、結果を書式化するために使用されるバッファのために十分なメモリを割り付けることができないなら、エラーが返されます。ウィンドウのポインタが NULL であるなら、エラーを返します。
移植性
これらの関数は、XSI Curses standard, Issue 4 に記述されています。関数
vwprintw は、"取り止める"とマークされていて、
<stdarg.h> インタフェースを使用する、関数
vw_printw によって置き換えられることになっています。 Single Unix Specification, Version 2 は、
<stdarg.h> と同じファイルで使用することができない、
<varargs.h> をインクルードする必要があるので、
vw_printw が
vwprintw より優先されると記載しています。この実装は、ヘッダが
<curses.h>にインクルードされるので、両方とも
<stdarg.h> を使用します。
関連項目
curses(3X),
printf(3),
vprintf(3)