X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_addwstr.3x.html;h=4f4805c7c1c744281f70cfe8d00f165e05462ff7;hb=67327e4e3b2121f8273fb73ec14ef234ed01231e;hp=6fea2aea30964d6b1b698fd464f1361e856e09bb;hpb=47d2fb4537d9ad5bb14f4810561a327930ca4280;p=ncurses.git diff --git a/doc/html/man/curs_addwstr.3x.html b/doc/html/man/curs_addwstr.3x.html index 6fea2aea..4f4805c7 100644 --- a/doc/html/man/curs_addwstr.3x.html +++ b/doc/html/man/curs_addwstr.3x.html @@ -1,6 +1,6 @@ - -curs_addwstr 3x +curs_addwstr 3x 2023-11-18 ncurses 6.4 Library calls - + -

curs_addwstr 3x

+

curs_addwstr 3x 2023-11-18 ncurses 6.4 Library calls

-curs_addwstr(3x)                                              curs_addwstr(3x)
+curs_addwstr(3x)                 Library calls                curs_addwstr(3x)

NAME

-       addwstr, addnwstr, waddwstr, waddnwstr, mvaddwstr, mvaddnwstr,
-       mvwaddwstr, mvwaddnwstr - add a string of wide characters to a curses
-       window and advance cursor
+       addwstr,   addnwstr,   waddwstr,   waddnwstr,   mvaddwstr,  mvaddnwstr,
+       mvwaddwstr, mvwaddnwstr - add  a  wide-character  string  to  a  curses
+       window and advance the cursor

SYNOPSIS

@@ -59,6 +59,7 @@
        int addnwstr(const wchar_t *wstr, int n);
        int waddwstr(WINDOW *win, const wchar_t *wstr);
        int waddnwstr(WINDOW *win, const wchar_t *wstr, int n);
+
        int mvaddwstr(int y, int x, const wchar_t *wstr);
        int mvaddnwstr(int y, int x, const wchar_t *wstr, int n);
        int mvwaddwstr(WINDOW *win, int y, int x, const wchar_t *wstr);
@@ -67,24 +68,29 @@

DESCRIPTION

        These  functions  write the characters of the (null-terminated) wchar_t
-       character string wstr on the given window.  It is similar to construct-
-       ing a cchar_t for each wchar_t in the string, then calling wadd_wch for
-       the resulting cchar_t.
+       character  string  wstr  on  the  given  window.   It  is  similar   to
+       constructing  a  cchar_t  for  each wchar_t in the string, then calling
+       wadd_wch(3x) for the resulting cchar_t:
+
+       o   spacing and non-spacing characters in the string are processed  one
+           at a time, and
+
+       o   control characters are processed as in waddch(3x).
 
-       The mv functions perform cursor movement once, before writing any char-
-       acters.  Thereafter, the cursor is advanced as a side-effect of writing
-       to the window.
+       The  mv  functions  perform  cursor  movement  once, before writing any
+       characters.  Thereafter, the cursor is advanced  as  a  side-effect  of
+       writing to the window.
 
-       The four functions with n as the last argument write at most n  wchar_t
-       characters,  or  until a terminating null is reached.  If n is -1, then
+       The  four functions with n as the last argument write at most n wchar_t
+       characters, or until a terminating null is reached.  If n is  -1,  then
        the entire string will be added.

RETURN VALUE

        All functions return the integer ERR upon failure and OK on success.
 
-       X/Open does not define any error conditions.  This  implementation  re-
-       turns an error
+       X/Open  does  not  define  any  error  conditions.  This implementation
+       returns an error
 
        o   if the window pointer is null or
 
@@ -92,7 +98,7 @@
 
        o   if the corresponding calls to wadd_wch return an error.
 
-       Functions  with  a  "mv"  prefix  first perform a cursor movement using
+       Functions with a "mv" prefix first  perform  a  cursor  movement  using
        wmove, and return an error if the position is outside the window, or if
        the window pointer is null.
 
@@ -106,11 +112,12 @@

SEE ALSO

-       curses(3x), curs_add_wch(3x)
+       curses(3x),   curs_addch(3x),    curs_addchstr(3x),    curs_addstr(3x),
+       curs_add_wch(3x), curs_add_wchstr(3x)
 
 
 
-                                                              curs_addwstr(3x)
+ncurses 6.4                       2023-11-18                  curs_addwstr(3x)