Manual Pages for UNIX Operating System command usage for man wgetwstr

Curses Library Functions                    curs_getwstr(3CURSES)



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

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

     int getwstr(wchar_t *wstr);


     int getnwstr(wchar_t *wstr, int n);


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


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


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


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


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


     int mvwgetnwstr(WINDOW *win, int y, int x, wchar_t *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  wchar_t pointer  wstr. getnwstr()
     reads at most n  wchar_t 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  ERR  upon  failure  and  an
     integer value other than ERR upon successful completion.

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





SunOS 5.11          Last change: 31 Dec 1996                    1






Curses Library Functions                    curs_getwstr(3CURSES)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE 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