Curses Library Functions                    cursgetwstr(3CURSES)



NAME
     cursgetwstr,  getwstr,   getnwstr,   wgetwstr,   wgetnwstr,
     mvgetwstr, mvgetnwstr, mvwgetwstr, mvwgetnwstr - get wchart
     character strings from curses terminal keyboard

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

     int getwstr(wchart *wstr);


     int getnwstr(wchart *wstr, int n);


     int wgetwstr(WINDOW *win, wchart *wstr);


     int wgetnwstr(WINDOW *win, wchart *wstr, int n);


     int mvgetwstr(int y, int x, wchart *wstr);


     int mvgetnwstr(int y, int x, wchart *wstr, int n);


     int mvwgetwstr(WINDOW *win, int y, int x, wchart *wstr);


     int mvwgetnwstr(WINDOW *win, int y, int x, wchart *wstr, int n);


DESCRIPTION
     The effect of  getwstr() is as though a series of  calls  to
     getwch(3CURSES)  were  made,  until  a  newline and carriage
     return is received. The resulting value  is  placed  in  the
     area  pointed  to  by the  wchart pointer  wstr. getnwstr()
     reads at most n  wchart characters, thus preventing a  pos-
     sible  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, etc.).

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

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





SunOS 5.11          Last change: 31 Dec 1996                    1






Curses Library Functions                    cursgetwstr(3CURSES)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     curses(3CURSES), getwch(3CURSES), attributes(5)

NOTES
     The  header  file     automatically  includes  the
     header files , , and .


     Note that all routines except  wgetnwstr() may be macros.







































SunOS 5.11          Last change: 31 Dec 1996                    2