Curses Library Functions                  cursaddwchstr(3CURSES)



NAME
     cursaddwchstr,    addwchstr,    addwchnstr,     waddwchstr,
     waddwchnstr,    mvaddwchstr,   mvaddwchnstr,   mvwaddwchstr,
     mvwaddwchnstr - add string of wchart characters (and attri-
     butes) to a curses window

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


     #include

     int addwchstr(chtype *wchstr);


     int addwchnstr(chtype *wchstr, int n);


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


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


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


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


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


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


DESCRIPTION
     All of these routines copy wchstr, which points to a  string
     of wchart characters, directly into the window image struc-
     ture starting at the current cursor position. The four  rou-
     tines  with  n as the last argument copy at most n elements,
     but no more than will fit on the  line.  If  n=-1  then  the
     whole  string  is  copied, to the maximum number that fit on
     the line.


     The position of the window cursor  is  not  advanced.  These
     routines  work  faster than  waddnwstr(3CURSES) because they
     merely copy wchstr into the window image structure.  On  the
     other  hand,  care  must be taken when using these functions
     because they don't perform any kind of checking (such as for
     the  newline  character),  they  do  not advance the current



SunOS 5.11          Last change: 31 Dec 1996                    1






Curses Library Functions                  cursaddwchstr(3CURSES)



     cursor position, and they truncate the string,  rather  than
     wrapping it around to the new line.

RETURN VALUE
     All routines return the integer  ER  upon  failure  and  an
     integer  value  other  than  ER upon successful completion,
     unless otherwise noted in  the  preceding  routine  descrip-
     tions.

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Unsafe                      
    


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

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


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


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




















SunOS 5.11          Last change: 31 Dec 1996                    2