manページ  — curs_scanw

scanw, wscanw, mvscanw, mvwscanw, vwscanw - convert formatted input from a ncurses widow

書式 解説 戻り値 関連項目

#include <ncurses.h>

int scanw(char *fmt [, arg] ...);
int wscanw(WINDOW *win, char *fmt [, arg] ...);
int mvscanw(int y, int x, char *fmt [, arg] ...);
int mvwscanw(WINDOW *win, int y, int x,
char *fmt [, arg] ...);
int vwscanw(WINDOW *win, char *fmt, va_list varglist);

scanw 、 wscanw 、および mvscanw の各ルーチンは、 scanf [ scanf(3) を参照 ] に類似しています。 これらのルーチンの効果は、ウィンドウで wgetstr が呼び出されたかのようであり、結果の行は sscanf(3) 用の入力として使用されます。 fmt フィールド内の変数にマップされないフィールドは失われます。

vwscanw ルーチンは、変数引数リストを使用して wscanw を実行するという点で、 vwprintw に類似しています。 3 番めの引数は va_list です。これは、 <varargs.h> で定義された引数リストを指すポインタです。

vwscanw は、処理が失敗すると ERR を返し、処理が成功すると走査された フィールドの数に等しい整数を返します。

アプリケーションは、 scanw 、 wscanw 、 mvscanw 、および mvwscanw の各ルーチンの 戻り値を使用して、呼び出しでマップされたフィールドの数を判定できます。