Curses Library Functions                     cursgetstr(3CURSES)



NAME
     cursgetstr, getstr, wgetstr, mvgetstr, mvwgetstr,  wgetnstr
     - get character strings from curses terminal keyboard

SYNOPSIS
     cc [ flag ... ] file ... -lcurses [ library ... ]
     #include 

     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 inter-
     preted, as well as any special keys (such as function  keys,
     HOME key, and CLEAR key.)

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

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Unsafe                      
    


SEE ALSO




SunOS 5.11          Last change: 31 Dec 1996                    1






Curses Library Functions                     cursgetstr(3CURSES)



     cursgetch(3CURSES), curses(3CURSES), attributes(5)

NOTES
     The header   automatically  includes  the  headers
      and .


     Note that getstr(), mvgetstr(), and mvwgetstr() may be  mac-
     ros.














































SunOS 5.11          Last change: 31 Dec 1996                    2