curs_getstr(3X) (MLX Addendum)     (MLX)     curs_getstr(3X) (MLX Addendum)

NAME
     cursgetstr: getstr, wgetstr, wgetnstr, mvgetstr, mvwgetstr, - get
     character strings from curses terminal keyboard (MLX addendum)

SYNOPSIS
     #include <curses.h>

     int getstr(char *str);
     int wgetstr(WINDOW *win, char *str);
     int wgetnstr(WINDOW *win, char *str, int n);
     int mvgetstr(int y, int x, char *str);
     int mvwgetstr(WINDOW *win, int y, int x, char *str);

DESCRIPTION
     The effect of getstr is as though a series of calls to getch were
     made, until a newline, carriage return or KEY_ENTER was received. The
     resulting value is placed in the area pointed to by the character
     pointer str. wgetnstr reads at most n-1 characters thus preventing a
     possible overflow of the input buffer, and leaving room for the ter-
     minating null. The user's erase and kill characters are interpreted,
     as well as any special keys (such as function keys, "home" key,
     "clear" key, etc.).

     The newline, carriage return or KEY_ENTER, if any, is not stored in
     the buffer. A null is placed in the buffer after the last character
     read.

RETURN VALUE
     All routines return the integer ERR upon failure and an integer value
     other than ERR upon successful completion.

NOTES
     The header file <curses.h> automatically includes the header files
     <stdio.h> and <unctrl.h>.

     Note that all routines except wgetnstr may be macros.

SEE ALSO
     curses(3X), cursgetch(3X).
















Page 1                       Reliant UNIX 5.44                      12, 196