


curs_addchstr(3X)                               curs_addchstr(3X)


NNAAMMEE
       ccuurrss__aaddddcchhssttrr: aaddddcchhssttrr, aaddddcchhnnssttrr, wwaaddddcchhssttrr, wwaaddddcchhnnssttrr,
       mmvvaaddddcchhssttrr, mmvvaaddddcchhnnssttrr, mmvvwwaaddddcchhssttrr, mmvvwwaaddddcchhnnssttrr  -  add
       string of characters (and attributes) to a ccuurrsseess window

SSYYNNOOPPSSIISS
       ##iinncclluuddee <<ccuurrsseess..hh>>

       iinntt aaddddcchhssttrr((cchhttyyppee **cchhssttrr));;
       iinntt aaddddcchhnnssttrr((cchhttyyppee **cchhssttrr,, iinntt nn));;
       iinntt wwaaddddcchhssttrr((WWIINNDDOOWW **wwiinn,, cchhttyyppee **cchhssttrr));;
       iinntt wwaaddddcchhnnssttrr((WWIINNDDOOWW **wwiinn,, cchhttyyppee **cchhssttrr,, iinntt nn));;
       iinntt mmvvaaddddcchhssttrr((iinntt yy,, iinntt xx,, cchhttyyppee **cchhssttrr));;
       iinntt mmvvaaddddcchhnnssttrr((iinntt yy,, iinntt xx,, cchhttyyppee **cchhssttrr,, iinntt nn));;
       iinntt mmvvwwaaddddcchhssttrr((WWIINNDDOOWW **wwiinn,, iinntt yy,, iinntt xx,, cchhttyyppee **cchhssttrr));;
       iinntt mmvvwwaaddddcchhnnssttrr((WWIINNDDOOWW **wwiinn,, iinntt yy,, iinntt xx,, cchhttyyppee **cchhssttrr,,
       iinntt nn));;

DDEESSCCRRIIPPTTIIOONN
       These  routines copy _c_h_s_t_r 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n=--11  then  the
       whole  string  is copied, to the maximum number of charac-
       ters that will fit on the line.

       The window cursor is _n_o_t advanced, and these routines work
       faster  than wwaaddddnnssttrr.  On the other hand, they don't per-
       form any kind  of  checking  (such  as  for  the  newline,
       backspace,  or  carriage  return  characters),  they don't
       advance the current cursor  position,  they  don't  expand
       other  control  characters to ^-escapes, and they truncate
       the string if it crosses the  right  margin,  rather  then
       wrapping it around to the new line.


RREETTUURRNN VVAALLUUEESS
       All routines return the integer EERRRR upon failure and OOKK on
       success (the SVr4 manuals specify only "an  integer  value
       other than EERRRR") upon successful completion, unless other-
       wise noted in the preceding routine descriptions.

NNOOTTEESS
       Note that all routines except wwaaddddcchhnnssttrr may be macros.

PPOORRTTAABBIILLIITTYY
       All these entry points are described  in  the  XSI  Curses
       standard, Issue 4.

SSEEEE AALLSSOO
       ccuurrsseess(3X).






                                                                1


