X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_addwstr.3x.html;h=fc9d830d60bb57e1e8b1f98dc9f265e3819f2179;hb=4e793faf6575b2297482f77b2bc3d18105c0fc76;hp=d761b3516f343d5d2495dcefff38f2c85155f846;hpb=46722468f47c2b77b3987729b4bcf2321cccfd01;p=ncurses.git diff --git a/doc/html/man/curs_addwstr.3x.html b/doc/html/man/curs_addwstr.3x.html index d761b351..fc9d830d 100644 --- a/doc/html/man/curs_addwstr.3x.html +++ b/doc/html/man/curs_addwstr.3x.html @@ -1,7 +1,7 @@ - + @@ -40,10 +40,14 @@ 
 
+curs_addwstr(3x)                                       curs_addwstr(3x)
+
+
+

NAME

-       addwstr,   addnwstr,   waddwstr,   waddnwstr,   mvaddwstr,
+       addwstr, addnwstr, waddwstr, waddnwstr, mvaddwstr,
        mvaddnwstr, mvwaddwstr, mvwaddnwstr - add a string of wide
        characters to a curses window and advance cursor
 
@@ -64,50 +68,60 @@

DESCRIPTION

-       These  routines  write  the characters of the (null-termi-
-       nated) wchar_tcharacter string wstr on the  given  window.
+       These  functions  write the characters of the (null-termi-
+       nated) 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.
 
-       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.
+       The  mv  functions  perform  cursor  movement once, before
+       writing any characters.  Thereafter,  the  cursor  is  ad-
+       vanced as a side-effect of writing to the window.
 
-       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.
+       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 VALUES

-       All routines return the integer ERR upon failure and OK on
-       success.
+
RETURN VALUE
+       All functions return the integer ERR upon failure  and  OK
+       on success.
+
+       X/Open  does not define any error conditions.  This imple-
+       mentation returns an error
+
+       o   if the window pointer is null or
+
+       o   if the string pointer is null or
+
+       o   if the corresponding calls to wadd_wch return  an  er-
+           ror.
+
+       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.
 
 
 

 
NOTES
-       Note that all of these routines except  waddnwstr  may  be
-       macros.
+       All of these functions except waddnwstr may be macros.
 
 
 

 
PORTABILITY
-       All  these  entry  points  are described in the XSI Curses
-       standard, Issue 4.
+       These  functions are described in the XSI Curses standard,
+       Issue 4.
 
 
 

 
SEE ALSO
-       Functions: curses(3x), curs_add_wch(3x)
-
-
-
+       curses(3x), curs_add_wch(3x)
 
 
 
+                                                       curs_addwstr(3x)