ultrix man page for getstr

getstr(3cur)															      getstr(3cur)

Name
       getstr, mvgetstr, mvwgetstr, wgetstr - read string

Syntax
       #include <cursesX.h>

       int getstr(str)
       char *str;

       int wgetstr(win, str)
       WINDOW *win;
       char *str;

       int mvgetstr(y, x, str)
       int y, x;
       char *str;

       int mvwgetstr(win, y, x, str)
       WINDOW *win;
       int y, x;
       char *str;

Description
       The  routine  reads  characters from the terminal associated with the default window and stores them in a buffer until a carriage return or
       newline is received from The routine B is called by to read each character.

       The routine reads characters from the terminal associated with the specified window.  The characters are read from the current cursor posi-
       tion until a newline or carriage return is received.

       The routine reads characters from the terminal associated with the default window.  The characters are read from the specified cursor posi-
       tion until a newline or carriage return is received.

       The routine reads characters from the terminal associated with the specified window.  The characters are read  from  the  specified  cursor
       position until a newline or carriage return is received.

       The following information applies to all the routines.

       The  resulting  string is placed in the area pointed to by the character pointer The user's erase and kill characters are interpreted.  The
       area used to hold the string is assumed to be large enough to handle it, as does not check for buffer overflow.	If the area is	not  large
       enough, the result will be unpredictable.

       The routines and are macros.

Return Values
       The and functions return OK on success and ERR on error.

See Also
       getch(3cur)

																      getstr(3cur)