4 <STRONG>addchstr</STRONG>, <STRONG>addchnstr</STRONG>, <STRONG>waddchstr</STRONG>, <STRONG>waddchnstr</STRONG>, <STRONG>mvaddchstr</STRONG>,
5 <STRONG>mvaddchnstr</STRONG>, <STRONG>mvwaddchstr</STRONG>, <STRONG>mvwaddchnstr</STRONG> - add a string of
6 characters (and attributes) to a <STRONG>curses</STRONG> window
10 <H2>SYNOPSIS</H2><PRE>
11 <STRONG>#include</STRONG> <STRONG><curses.h></STRONG>
13 <STRONG>int</STRONG> <STRONG>addchstr(const</STRONG> <STRONG>chtype</STRONG> <STRONG>*chstr);</STRONG>
14 <STRONG>int</STRONG> <STRONG>addchnstr(const</STRONG> <STRONG>chtype</STRONG> <STRONG>*chstr,</STRONG> <STRONG>int</STRONG> <STRONG>n);</STRONG>
15 <STRONG>int</STRONG> <STRONG>waddchstr(WINDOW</STRONG> <STRONG>*win,</STRONG> <STRONG>const</STRONG> <STRONG>chtype</STRONG> <STRONG>*chstr);</STRONG>
16 <STRONG>int</STRONG> <STRONG>waddchnstr(WINDOW</STRONG> <STRONG>*win,</STRONG> <STRONG>const</STRONG> <STRONG>chtype</STRONG> <STRONG>*chstr,</STRONG> <STRONG>int</STRONG> <STRONG>n);</STRONG>
17 <STRONG>int</STRONG> <STRONG>mvaddchstr(int</STRONG> <STRONG>y,</STRONG> <STRONG>int</STRONG> <STRONG>x,</STRONG> <STRONG>const</STRONG> <STRONG>chtype</STRONG> <STRONG>*chstr);</STRONG>
18 <STRONG>int</STRONG> <STRONG>mvaddchnstr(int</STRONG> <STRONG>y,</STRONG> <STRONG>int</STRONG> <STRONG>x,</STRONG> <STRONG>const</STRONG> <STRONG>chtype</STRONG> <STRONG>*chstr,</STRONG> <STRONG>int</STRONG> <STRONG>n);</STRONG>
19 <STRONG>int</STRONG> <STRONG>mvwaddchstr(WINDOW</STRONG> <STRONG>*win,</STRONG> <STRONG>int</STRONG> <STRONG>y,</STRONG> <STRONG>int</STRONG> <STRONG>x,</STRONG> <STRONG>const</STRONG> <STRONG>chtype</STRONG>
20 <STRONG>*chstr);</STRONG>
21 <STRONG>int</STRONG> <STRONG>mvwaddchnstr(WINDOW</STRONG> <STRONG>*win,</STRONG> <STRONG>int</STRONG> <STRONG>y,</STRONG> <STRONG>int</STRONG> <STRONG>x,</STRONG> <STRONG>const</STRONG> <STRONG>chtype</STRONG>
22 <STRONG>*chstr,</STRONG> <STRONG>int</STRONG> <STRONG>n);</STRONG>
26 <H2>DESCRIPTION</H2><PRE>
27 These routines copy <EM>chstr</EM> into the window image structure
28 at and after the current cursor position. The four rou-
29 tines with <EM>n</EM> as the last argument copy at most <EM>n</EM> elements,
30 but no more than will fit on the line. If <STRONG>n</STRONG>=<STRONG>-1</STRONG> then the
31 whole string is copied, to the maximum number of charac-
32 ters that will fit on the line.
34 The window cursor is <EM>not</EM> advanced, and these routines work
35 faster than <STRONG>waddnstr</STRONG>. On the other hand, they don't per-
36 form any kind of checking (such as for the newline,
37 backspace, or carriage return characters), they don't
38 advance the current cursor position, they don't expand
39 other control characters to ^-escapes, and they truncate
40 the string if it crosses the right margin, rather then
41 wrapping it around to the new line.
46 <H2>RETURN VALUES</H2><PRE>
47 All routines return the integer <STRONG>ERR</STRONG> upon failure and <STRONG>OK</STRONG> on
48 success (the SVr4 manuals specify only "an integer value
49 other than <STRONG>ERR</STRONG>") upon successful completion, unless other-
50 wise noted in the preceding routine descriptions.
55 Note that all routines except <STRONG>waddchnstr</STRONG> may be macros.
59 <H2>PORTABILITY</H2><PRE>
60 All these entry points are described in the XSI Curses
65 <H2>SEE ALSO</H2><PRE>
66 <STRONG><A HREF="ncurses.3x.html">curses(3X)</A></STRONG>.