Curses Library Functions                   cursinwchstr(3CURSES)



NAME
     cursinwchstr, inwchstr, inwchnstr,  winwchstr,  winwchnstr,
     mvinwchstr,  mvinwchnstr,  mvwinwchstr, mvwinwchnstr - get a
     string of wchart characters (and attributes) from a  curses
     window

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

     int inwchstr(chtype *wchstr);


     int inwchnstr(chtype *wchstr, int n);


     int winwchstr(WINDOW *win, chtype *wchstr);


     int winwchnstr(WINDOW *win, chtype *wchstr, int n);


     int mvinwchstr(int y, int x, chtype *wchstr);


     int mvinwchnstr(int y, int x, chtype *wchstr, int n);


     int mvwinwchstr(WINDOW *win, int y, int x, chtype *wchstr);


     int mvwinwchnstr(WINDOW *win, int y, int x, chtype *wchstr, int n);


DESCRIPTION
     These routines return a  string  of  type   chtype,  holding
     wchart  characters, starting at the current cursor position
     in the named window and ending at the right  margin  of  the
     window.  The  four  functions  with  n as the last argument,
     return the string at most  n wchart characters  long.  Con-
     stants  defined in   can be used with the  logical
     AND (&) operator to extract the  wchart  character  or  the
     attribute  alone  from  any  position  in  the  wchstr  (see
     cursinwch(3CURSES)).

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                   cursinwchstr(3CURSES)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Unsafe                      
    


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

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


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


     None of these  routines  can  use  the  color  attribute  in
     chtype.



































SunOS 5.11          Last change: 31 Dec 1996                    2