NAME    [Toc]    [Back]

       curs_addwchstr,  addwchstr,  addwchnstr,  waddwchstr, waddwchnstr,
 mvaddwchstr, mvaddwchnstr, mvwaddwchstr,  mvwaddwchnstr
  -  Add  a  string  of  wchar_t  characters  (and
       attributes) to a Curses window

SYNOPSIS    [Toc]    [Back]

       #include <curses.h>

       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 );

LIBRARY    [Toc]    [Back]

       Curses Library (libcurses)

DESCRIPTION    [Toc]    [Back]

       All of these routines  copy  wchstr,  which  points  to  a
       string  of  wchar_t  characters,  directly into the window
       image structure starting at the current or specified  cursor
  position.  The four routines with n as the last argument
 copy at most n elements, but no more than will fit on
       the  line.  If  n=-1, then all the routines copy the whole
       string, to the maximum number that  fit  on  the  line  or
       until a null terminator is reached.

       The  routines  do  not  advance the position of the window
       cursor. They  work  faster  than  waddnwstr  because  they
       merely copy wchstr into the window image structure. On the
       other hand, care must be taken when using these  functions
       because they: Do not perform any kind of checking (such as
       for the newline character) Do not advance the current cursor
  position Truncate the string, rather then wrapping it
       around to the new line

NOTES    [Toc]    [Back]

       The header  file  <curses.h>  automatically  includes  the
       header file <stdio.h>.

       Note that all routines except waddwchnstr may be macros.

       The  routines  described  on this reference page are among
       the MNLS Curses functions that are  not  included  in  the
       X/Open  Curses  CAE specification.  MNLS routines are supported
 only for backward compatibility  reasons.  For  new
       applications,  use  the routines described on the add_wchstr(3) reference page.

RETURN VALUES    [Toc]    [Back]

       All routines return the integer ERR upon  failure  and  an
       integer  value  other than ERR upon successful completion,
       unless otherwise noted in the preceding  routine  descriptions.

SEE ALSO    [Toc]    [Back]

       Functions: curses(3), add_wchstr(3)



                                                curs_addwchstr(3)