curs_printw 3x

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 var-
       glist);
       int vw_printw(WINDOW *win, const char *fmt,  va_list  var-
       glist);

説明

       　printw,  wprintw, mvprintw, mvwprintw ルーチンは printf に
       類似したルーチンです。[printf(3) 参照]
       　実際には、printf が出力するはずの文字列を、代わりに指定の
       ウインドウで waddstr を使ったかのように出力します。

       　vwprintw と wv_printw ルーチンは vprintf に類似しており、 
       可変引数リストを使って wprintw を実行します。
       [printf(3) 参照]
       　第 3 引数は引数リストへのポインタで、<stdarg.h> で
       定義されている va_list 型です。

戻り値

       　整数を返すルーチンは、失敗のとき ERR を、正常終了のとき OK 
       (SVr4 は「ERR 以外の整数値」としか指定していません) を
       返します。

       　X/Open はエラーの条件を何も定義していません。
       　この実装では、結果に書式を付けるためのバッファに十分な
       メモリを割り当てられない場合にエラーを返すことがあります。
       　ウインドウ・ポインタがヌルの場合にエラーを返します。

         mv で始まる関数は、最初に wmove を使用してカーソルを移動し、
       位置がウインドウの外だった場合、またはウインドウ・ポインタが
       ヌルの場合にエラーを返します。

移植性

       　これらの関数は XSI Curses standard, Issue 4 に記載されて
       います。
       　vwprintw 関数は廃止項目と注記されており、
       <stdarg.h> インターフェイスを使った vw_printw 関数によって
       置き換えられるでしょう。
       　Single Unix Specification, Version 2 は、<stdarg.h> と
       同じファイルで使うことができない <varargs.h> を取り込む必要が
       ある vwprintw よりも vw_printw が適していると明記しています。
       　この実装では両方に <stdarg.h> を使っています。
       このヘッダファイルが <curses.h> で取り込まれるためです。

SEE ALSO 関連項目

       curses(3x), printf(3), vprintf(3)



                                                        curs_printw(3x)