curs_getstr(3ocurses)
curs_getstr: getstr, wgetstr, mvgetstr, mvwgetstr, wgetnstr --
get character strings from curses terminal keyboard
Synopsis
cc [flag . . .] file -locurses [library . . .]
#include <ocurses.h>
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);
Description
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).
Return values
All routines return the integer ERR upon
failure and an integer value other than ERR
upon successful completion.
References
curses(3ocurses),
curs_getch(3ocurses)
Notices
The header file ocurses.h automatically includes the header files
stdio.h and unctrl.h.
Note that getstr, mvgetstr, and mvwgetstr may
be macros.
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004