curs_getstr: getstr, wgetstr, mvgetstr, mvwgetstr, wgetnstr --
get character strings from curses terminal keyboard
cc [flag . . .] file -locurses [library . . .]
int getstr(char str);
int wgetstr(WINDOW win, char str);
int mvgetstr(int y, int x, char str);
int mvwgetstr(WINDOW win, int y, int x, char str);
int wgetnstr(WINDOW win, char str, int n);
The effect of getstr is as though a series of calls to
getch were made, until a newline or carriage return is received.
The resulting value is placed in the area pointed to by
the character pointer str.
wgetnstr reads at most n characters,
thus preventing a possible overflow of the input buffer.
The user's erase and kill characters are interpreted, as well as any
special keys (such as function keys, ``home'' key, ``clear'' key,
and so on).
All routines return the integer ERR upon
failure and an integer value other than ERR
upon successful completion.
The header file ocurses.h automatically includes the header files
stdio.h and unctrl.h.
Note that getstr, mvgetstr, and mvwgetstr may
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004