X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_addwstr.3x.html;h=4f4805c7c1c744281f70cfe8d00f165e05462ff7;hb=e2c422e26543d96636d8bde422550ea9c7005e9c;hp=99ab802ec689ea8978d4c850ec5fbd763c6e217c;hpb=3a935d9991cdf43ebfa952073c9b555f73a3e011;p=ncurses.git diff --git a/doc/html/man/curs_addwstr.3x.html b/doc/html/man/curs_addwstr.3x.html index 99ab802e..4f4805c7 100644 --- a/doc/html/man/curs_addwstr.3x.html +++ b/doc/html/man/curs_addwstr.3x.html @@ -1,7 +1,7 @@ - - + -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
+

NAME

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

SYNOPSIS

+

SYNOPSIS

        #include <curses.h>
 
        int addwstr(const wchar_t *wstr);
        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);
        int mvwaddnwstr(WINDOW *win, int y, int x, const wchar_t *wstr, int n);
 
 
-
-

DESCRIPTION

-       These routines write the characters of the (null-terminat-
-       ed) wchar_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  for  the  resulting
-       cchar_t.
+

DESCRIPTION

+       These  functions  write the characters of the (null-terminated) wchar_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:
 
-       The mv routines perform cursor movement once, before writ-
-       ing any characters.  Thereafter, the cursor is advanced as
-       a side-effect of writing to the window.
+       o   spacing and non-spacing characters in the string are processed  one
+           at a time, and
 
-       The  four  routines  with  n as the last argument write at
-       most n wchar_t characters.  If n is -1,  then  the  entire
-       string  will be added, up to the maximum number of charac-
-       ters that will fit on the line,  or  until  a  terminating
-       null is reached.
+       o   control characters are processed as in waddch(3x).
 
+       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.
 
-
-

RETURN VALUES

-       All routines return the integer ERR upon failure and OK on
-       success.
+       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.
 
-       Functions with a "mv" prefix first perform a cursor  move-
-       ment  using  wmove, and return an error if the position is
-       outside the window, or if the window pointer is null.
 
+

RETURN VALUE

+       All functions return the integer ERR upon failure and OK on success.
 
-
-

NOTES

-       Note that all of these routines except  waddnwstr  may  be
-       macros.
+       X/Open  does  not  define  any  error  conditions.  This implementation
+       returns an error
 
+       o   if the window pointer is null or
 
-
-

PORTABILITY

-       All  these  entry  points  are described in the XSI Curses
-       standard, Issue 4.
+       o   if the string pointer is null or
 
+       o   if the corresponding calls to wadd_wch return an error.
 
-
-

SEE ALSO

-       curses(3x), curs_add_wch(3x)
+       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.
+
+
+

NOTES

+       All of these functions except waddnwstr may be macros.
+
+
+

PORTABILITY

+       These functions are described in the XSI Curses standard, Issue 4.
+
+
+

SEE ALSO

+       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)
-
-
-Man(1) output converted with -man2html -
+
+ +