X/Open Curses Library Functions             addwchnstr(3XCURSES)



NAME
     addwchnstr,   addwchstr,   mvaddwchnstr,    mvaddwchstr,
     mvwaddwchnstr,  mvwaddwchstr,  waddwchnstr, waddwchstr -
     copy a string of complex characters (with renditions)  to  a
     window

SYNOPSIS
     cc [ flag... ] file... -I /usr/xpg4/include  -L  /usr/xpg4/lib \
      -R  /usr/xpg4/lib  -lcurses  [ library... ]

     c89 [ flag... ] file... -lcurses [ library ... ]

     #include 

     int addwchnstr(const cchart *wchstr, int n);


     int addwchstr(const cchart *wchstr);


     int mvaddwchnstr(int y, int x, const cchart *wchstr, int n);


     int mvaddwchstr(int y, int x, const cchart *wchstr);


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


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


     int waddwchstr(WINDOW *win, const cchart *wchstr);


     int waddwchnstr(WINDOW *win, const cchart *wchstr, int n);


DESCRIPTION
     The addwchstr() function copies the string of cchart char-
     acters  to the stdscr window at the current cursor position.
     The mvaddwchstr() and mvwaddwchstr()  functions  copy  the
     string  to the starting position indicated by the x (column)
     and y  (row) parameters (the former to  the  stdscr  window;
     the  latter  to window win).  The waddwchstr() is identical
     to addwchstr(), but writes  to the window specified by win.


     The  addwchnstr(),  waddwchnstr(),  mvaddwchnstr(),   and
     mvwaddwchnstr() functions write n characters to the window,
     or as many as will fit on the line. If n is less than 0, the



SunOS 5.11           Last change: 5 Jun 2002                    1






X/Open Curses Library Functions             addwchnstr(3XCURSES)



     entire  string  is written, or as much of it as  fits on the
     line.  The former two functions  place  the  string  at  the
     current  cursor  position;  the  latter two commands use the
     position specified by the x and y parameters.


     These functions differ from  the  addwstr(3XCURSES)  set  of
     functions  in two important respects. First, these functions
     do not advance the cursor after writing the  string  to  the
     window.  Second,  the current window rendition (that is, the
     combination of attributes  and color pair) is  not  combined
     with  the character; only those attributes that  are already
     part of the cchart character are used.

PARAMETERS
     wchstr    Is a pointer to the cchart string to be copied to
               the window.


     n         Is the maximum number of characters to  be  copied
               from  wchstr.    If  n  is less than 0, the entire
               string is written or as much of it as fits on  the
               line.


     y         Is the y (row) coordinate of the starting position
               of wchstr in the window.


     x         Is the x (column) coordinate of the starting posi-
               tion of wchstr  in the window.


     win       Is a pointer to the window to which the string  is
               to be copied.


RETURN VALUES
     On success,  these  functions  return  OK.  Otherwise,  they
     return ER.

ERORS
     None.

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








SunOS 5.11           Last change: 5 Jun 2002                    2






X/Open Curses Library Functions             addwchnstr(3XCURSES)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     addnwstr(3XCURSES),  addwch(3XCURSES),  attroff(3XCURSES),
     libcurses(3XCURSES), attributes(5), standards(5)











































SunOS 5.11           Last change: 5 Jun 2002                    3