ncurses 4.2
[ncurses.git] / Ada95 / html / curs_addchstr.3x.html
1 <HTML>
2 <BODY BGCOLOR="#99ccbb" TEXT="#000000" LINK="#4060b0" VLINK="#000080" ALINK="#ff4040">
3 <PRE>
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
7
8
9 </PRE>
10 <H2>SYNOPSIS</H2><PRE>
11        <STRONG>#include</STRONG> <STRONG>&lt;curses.h&gt;</STRONG>
12
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>
23
24
25 </PRE>
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.
33
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.
42
43
44
45 </PRE>
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.
51
52
53 </PRE>
54 <H2>NOTES</H2><PRE>
55        Note that all routines except <STRONG>waddchnstr</STRONG> may be macros.
56
57
58 </PRE>
59 <H2>PORTABILITY</H2><PRE>
60        All  these  entry  points  are described in the XSI Curses
61        standard, Issue 4.
62
63
64 </PRE>
65 <H2>SEE ALSO</H2><PRE>
66        <STRONG><A HREF="ncurses.3x.html">curses(3X)</A></STRONG>.
67
68 </PRE>
69 </BODY>
70 </HTML>