curs_addch(3X)							curs_addch(3X)

NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     #include <curses.h>

     addch(chtype ch);

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

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

     wechochar(WINDOW *win, chtype ch);

DESCRIPTION    [Toc]    [Back]

     The addch,	waddch,	mvaddch, and mvwaddch routines put the character ch
     into the window at	the current cursor position of the window and advance
     the position of the window	cursor.	 Their 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.

     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 inch	and addch.)  [see standout, predefined video attribute
     constants,	on the curs_attr(3X) 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 family.	When variables are defined for
     the terminal, the A_ALTCHARSET bit	is turned on [see curs_attr(3X)].
     Otherwise,	the default character listed below is stored in	the variable.
     The names chosen are consistent with the VT100 nomenclature.




									Page 1






curs_addch(3X)							curs_addch(3X)



		_________________________________________________

		 Name		Default	  Glyph	Description
		 ________________________________________________
		 ACS_ULCORNER	+	  upper	left-hand corner
		 ACS_LLCORNER	+	  lower	left-hand corner
		 ACS_URCORNER	+	  upper	right-hand corner
		 ACS_LRCORNER	+	  lower	right-hand corner
		 ACS_RTEE	+	  right	tee (-|)
		 ACS_LTEE	+	  left tee (-)
		 ACS_BTEE	+	  bottom tee (|)
		 ACS_TTEE	+	  top tee (|)
		 ACS_HLINE	-	  horizontal line
		 ACS_VLINE	|	  vertical line
		 ACS_PLUS	+	  plus
		 ACS_S1		-	  scan line 1
		 ACS_S9		_	  scan line 9
		 ACS_DIAMOND	+	  diamond
		 ACS_CKBOARD	:	  checker board	(stipple)
		 ACS_DEGREE	'	  degree symbol
		 ACS_PLMINUS	#	  plus/minus
		 ACS_BULLET	o	  bullet
		 ACS_LARROW	<	  arrow	pointing left
		 ACS_RARROW	>	  arrow	pointing right
		 ACS_DARROW	v	  arrow	pointing down
		 ACS_UARROW		  arrow	pointing up
		 ACS_BOARD	^	  board	of squares
		 ACS_LANTERN	#	  lantern symbol
		 ACS_BLOCK	#	  solid	square block
		 ________________________________________________

RETURN VALUE    [Toc]    [Back]

     All routines return the integer ERR upon failure and an integer value
     other than	ERR upon successful completion,	unless otherwise noted in the
     preceding routine descriptions.

NOTES    [Toc]    [Back]

     The header	file curses.h automatically includes the header	files stdio.h
     and unctrl.h.

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

SEE ALSO    [Toc]    [Back]

     curses(3X), curs_attr(3X),	curs_clear(3X),	curs_inch(3X),
     curs_outopts(3X), curs_refresh(3X)	putc(3S)


									PPPPaaaaggggeeee 2222