X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_addwstr.3x.html;h=c24cfa2bfecb2d5447198064b54a207fc962bdaa;hp=5bfd04e605891bc825737667bb6accfa46d59b60;hb=027d0c57c4c4d6690e8d8727888d3282dbe9aa86;hpb=55ccd2b959766810cf7db8d1c4462f338ce0afc8 diff --git a/doc/html/man/curs_addwstr.3x.html b/doc/html/man/curs_addwstr.3x.html index 5bfd04e6..c24cfa2b 100644 --- a/doc/html/man/curs_addwstr.3x.html +++ b/doc/html/man/curs_addwstr.3x.html @@ -1,7 +1,6 @@ - + + + curs_addwstr 3x -

curs_addwstr 3x

-
+

curs_addwstr 3x

-
 curs_addwstr(3x)                                       curs_addwstr(3x)
-

NAME

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

-
SYNOPSIS
+
SYNOPSIS
        #include <curses.h>
 
        int addwstr(const wchar_t *wstr);
@@ -67,54 +67,72 @@
 
 
 

-
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
+
DESCRIPTION
+       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.
+
NOTES
+       All of these functions except waddnwstr may be macros.
 
 
 

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

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

-

-

-Man(1) output converted with
-man2html
-

+

+
+