Curses Library Functions                      cursaddch(3CURSES)



NAME
     cursaddch,  addch,  waddch,  mvaddch,  mvwaddch,  echochar,
     wechochar  -  add  a character (with attributes) to a curses
     window and advance cursor

SYNOPSIS
     cc [ flag ... ] file ... -lcurses [ library .. ]
     #include 

     int addch(chtype ch);


     int waddch(WINDOW *win, chtype ch);


     int mvaddch(int y, int x, chtype ch);


     int mvwaddch(WINDOW *win, int y, int x, chtype ch);


     int echochar(chtype ch);


     int wechochar(WINDOW *win, chtype ch);


DESCRIPTION
     With the addch(), waddch(), mvaddch(), and  mvwaddch()  rou-
     tines,  the  character  ch  is  put  into  the window at the
     current cursor position of the window and  the  position  of
     the  window  cursor  is advanced. Its function is similar to
     that of putchar(). At the right margin, an automatic newline
     is  performed.  At  the  bottom  of the scrolling region, if
     scrollok() is enabled, the scrolling region is  scrolled  up
     one line.


     If ch is a tab, newline, or backspace, the cursor  is  moved
     appropriately  within  the  window.  A  newline  also does a
     clrtoeol() before moving. Tabs are considered to be at every
     eighth  column.  If  ch  is another control character, it is
     drawn in the ^X notation. Calling  winch()  after  adding  a
     control character does not return the control character, but
     instead returns the representation of the control character.
     See cursinch(3CURSES).


     Video attributes can be combined with a character by  OR-ing
     them  into  the  parameter. This results in these attributes
     also being set. (The intent here  is  that  text,  including
     attributes,  can  be  copied from one place to another using



SunOS 5.11          Last change: 31 Dec 1996                    1






Curses Library Functions                      cursaddch(3CURSES)



     inch()  and  addch().)  (see  standout(),  predefined  video
     attribute constants, on the cursattr(3CURSES) page).


     The echochar() and  wechochar()  routines  are  functionally
     equivalent  to  a  call  to  addch()  followed  by a call to
     refresh(), or a  call  to  waddch  followed  by  a  call  to
     wrefresh().  The  knowledge  that only a single character is
     being output is  taken  into  consideration  and,  for  non-
     control characters, a considerable performance gain might be
     seen by using these routines instead of their equivalents.

  Line Graphics
     The following variables may be  used  to  add  line  drawing
     characters  to  the screen with routines of the addch() fam-
     ily.  When variables  are  defined  for  the  terminal,  the
     ALTCHARSET bit is turned on (see cursattr(3CURSES)). Oth-
     erwise, the default character listed below is stored in  the
     variable.  The  names  chosen  are consistent with the VT100
     nomenclature.



































SunOS 5.11          Last change: 31 Dec 1996                    2






Curses Library Functions                      cursaddch(3CURSES)


























































SunOS 5.11          Last change: 31 Dec 1996                    3






Curses Library Functions                      cursaddch(3CURSES)



     
             Name             Default         Glyph Description
     
      ACSULCORNER         ]               upper left-hand corner
     
      ACSLCORNER         ]               lower left-hand corner
     
      ACSURCORNER         ]               upper right-hand corner
     
      ACSLRCORNER         ]               lower right-hand corner
     
      ACSRTE             ]               right tee
     
      ACSLTE             ]               left tee
     
      ACSBTE             ]               bottom tee
     
      ACSTE             ]               top tee
     
      ACSHLINE            -               horizontal line
     
      ACSVLINE                           vertical line
     
      ACSPLUS             ]               plus
     
      ACS1               -               scan line 1
     
      ACS9               -               scan line 9
     
      ACSDIAMOND          ]               diamond
     
      ACSCKBOARD          :               checker board (stipple)
     
      ACSDEGRE           '               degree symbol
     
      ACSPLMINUS          #               plus/minus
     
      ACSBULET           o               bullet
     
      ACSLAROW           <               arrow pointing left
     
      ACSRAROW           >               arrow pointing right
     
      ACSDAROW           v               arrow pointing down
     
      ACSUAROW           ^               arrow pointing up
     
      ACSBOARD            #               board of squares
     
      ACSLANTERN          #               lantern symbol
     
      ACSBLOCK            #               solid square block



SunOS 5.11          Last change: 31 Dec 1996                    4






Curses Library Functions                      cursaddch(3CURSES)



     


RETURN VALUES
     All routines return the integer  ER  upon  failure  and  an
     integer value other than ER upon successful completion.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     cursattr(3CURSES), cursclear(3CURSES), cursinch(3CURSES),
     cursoutopts(3CURSES),                cursrefresh(3CURSES),
     curses(3CURSES), putc(3C), attributes(5)

NOTES
     The header   automatically  includes  the  headers
      and .


     Note that addch(), mvaddch(), mvwaddch(), and echochar() may
     be macros.























SunOS 5.11          Last change: 31 Dec 1996                    5