X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_addchstr.3x.html;h=886e7aa778fa2fa8854f86ead0d2e5373d667723;hp=dae7b70a55a943d3bdec0b1e9fdec021bd043cfc;hb=e5d1530ca229aef94a3c84ad33f8ae89f35c4045;hpb=55ccd2b959766810cf7db8d1c4462f338ce0afc8;ds=sidebyside diff --git a/doc/html/man/curs_addchstr.3x.html b/doc/html/man/curs_addchstr.3x.html index dae7b70a..886e7aa7 100644 --- a/doc/html/man/curs_addchstr.3x.html +++ b/doc/html/man/curs_addchstr.3x.html @@ -1,7 +1,7 @@ - + + + curs_addchstr 3x - + -

curs_addchstr 3x

-
+

curs_addchstr 3x

-
-curs_addchstr(3x)                                     curs_addchstr(3x)
+curs_addchstr(3x)                                            curs_addchstr(3x)
 
 
 
 
-
-

NAME

-       addchstr, addchnstr, waddchstr, waddchnstr, mvaddchstr,
-       mvaddchnstr, mvwaddchstr, mvwaddchnstr - add a string of
-       characters (and attributes) to a curses window
+

NAME

+       addchstr, addchnstr, waddchstr, waddchnstr, mvaddchstr, mvaddchnstr,
+       mvwaddchstr, mvwaddchnstr - add a string of characters (and attributes)
+       to a curses window
 
 
-
-

SYNOPSIS

+

SYNOPSIS

        #include <curses.h>
 
-       int addchstr(const chtype *chstr);
-       int addchnstr(const chtype *chstr, int n);
-       int waddchstr(WINDOW *win, const chtype *chstr);
-       int waddchnstr(WINDOW *win, const chtype *chstr, int n);
-       int mvaddchstr(int y, int x, const chtype *chstr);
-       int mvaddchnstr(int y, int x, const chtype *chstr, int n);
-       int mvwaddchstr(WINDOW *win, int y, int  x,  const  chtype
-       *chstr);
-       int  mvwaddchnstr(WINDOW  *win, int y, int x, const chtype
-       *chstr, int n);
+       int addchstr(const chtype *chstr);
+       int addchnstr(const chtype *chstr, int n);
+       int waddchstr(WINDOW *win, const chtype *chstr);
+       int waddchnstr(WINDOW *win, const chtype *chstr, int n);
 
+       int mvaddchstr(int y, int x, const chtype *chstr);
+       int mvaddchnstr(int y, int x, const chtype *chstr, int n);
+       int mvwaddchstr(WINDOW *win, int y, int x, const chtype *chstr);
+       int mvwaddchnstr(WINDOW *win, int y, int x, const chtype *chstr, int n);
 
-
-

DESCRIPTION

-       These routines copy chstr into the window image  structure
-       at  and  after the current cursor position.  The four rou-
-       tines with n as the last argument copy at most n elements,
-       but  no  more than will fit on the line.  If n=-1 then the
-       whole string is copied, to the maximum number  of  charac-
-       ters that will fit on the line.
-
-       The window cursor is not advanced, and these routines work
-       faster than waddnstr.  On the other hand, they do not per-
-       form  any  kind  of  checking  (such  as  for the newline,
-       backspace, or carriage return characters), they do not ad-
-       vance the current cursor position, they do not expand oth-
-       er control characters to ^-escapes, and they truncate  the
-       string  if  it crosses the right margin, rather then wrap-
-       ping it around to the new line.
 
+

DESCRIPTION

+       These  functions copy the (null-terminated) chstr array into the window
+       image structure starting at the  current  cursor  position.   The  four
+       functions  with  n as the last argument copy at most n elements, but no
+       more than will fit on the line.   If  n=-1  then  the  whole  array  is
+       copied, to the maximum number of characters that will fit on the line.
 
-
-

RETURN VALUES

-       All routines return the integer ERR upon failure and OK on
-       success  (the  SVr4 manuals specify only "an integer value
-       other than ERR") upon successful completion, unless other-
-       wise noted in the preceding routine descriptions.
+       The  window  cursor  is not advanced.  These functions work faster than
+       waddnstr.  On the other hand:
 
-       X/Open  does not define any error conditions.  This imple-
-       mentation returns an error if the window pointer is  null.
+       o   they do not perform checking (such as for the  newline,  backspace,
+           or carriage return characters),
 
+       o   they do not advance the current cursor position,
 
-
-

NOTES

-       Note that all routines except waddchnstr may be macros.
+       o   they do not expand other control characters to ^-escapes, and
 
+       o   they  truncate  the  string  if it crosses the right margin, rather
+           than wrapping it around to the new line.
 
-
-

PORTABILITY

-       These  entry  points are described in the XSI Curses stan-
-       dard, Issue 4.
 
+

RETURN VALUE

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

SEE ALSO

-       curses(3x).
+       X/Open does not define any error conditions.  This  implementation  re-
+       turns an error if the window pointer is null.
+
+       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 functions except waddchnstr may be macros.
+
+
+

PORTABILITY

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

SEE ALSO

+       curs_addstr(3x), curses(3x).
+
+       Comparable  functions  in the wide-character (ncursesw) library are de-
+       scribed in curs_add_wchstr(3x).
 
 
 
-                                                      curs_addchstr(3x)
+                                                             curs_addchstr(3x)
-
-
-Man(1) output converted with -man2html -
+
+ +