mvaddwch man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

curs_addwch(3)							curs_addwch(3)

NAME
       curs_addwch,   addwch,	waddwch,   mvaddwch,   mvwaddwch,   echowchar,
       wechowchar - Add a wchar_t character (with attributes) to a Curses win‐
       dow and advance cursor

SYNOPSIS
       #include <curses.h>

       int addwch(
	       chtype wch ); int waddwch(
	       WINDOW *win,
	       chtype wch ); int mvaddwch(
	       int y,
	       int x,
	       chtype wch ); int mvwaddwch(
	       WINDOW *win,
	       int y,
	       int x,
	       chtype wch ); int echowchar(
	       chtype wch ); int wechowchar(
	       WINDOW *win,
	       chtype wch );

LIBRARY
       Curses Library (libcurses)

DESCRIPTION
       The addwch, waddwch, mvaddwch, and mvwaddwch routines put the character
       wch, holding a wchar_t character, 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	putwchar  in  the  Standard  C
       Library.	 At  the  right margin, the routines perform an automatic new‐
       line. At the bottom of the scrolling region, if	scrollok  is  enabled,
       the routines scroll the scrolling region up one line.

       If  wch	is  a tab, newline, or backspace, the routines move the cursor
       appropriately within the window. A newline  also	 results  in  clrtoeol
       before moving. Tabs are considered to be at every eighth column. If wch
       is another control character, it is drawn in the ^X  notation.  Calling
       winwch  after  adding  a	 control character does not return the control
       character, but instead returns the representation of the control	 char‐
       acter.

       Video attributes can be combined with a wchar_t character in the param‐
       eter by means of an inclusive OR operation. This	 operation  also  sets
       the   attributes.   (The	 intent	 here  is  to  allow  text,  including
       attributes, to be copied from one place to another by using  inwch  and
       addwch. See the discussion of standout, predefined video attribute con‐
       stants, in the curs_attr(3) reference page.)

       The echowchar and wechowchar routines are functionally equivalent to  a
       call to addwch followed by a call to refresh, or a call to waddwch fol‐
       lowed by a call to wrefresh. The knowledge that only a single character
       is being output is taken into consideration and, for noncontrol charac‐
       ters, a considerable performance gain may be realized  by  using	 these
       routines instead of their equivalents.

   Line Graphics
       The  following variables may be used with routines of the addwch family
       to add line-drawing  characters	to  the	 screen.  When	variables  are
       defined	for  the  terminal,  the  A_ALTCHARSET	bit  is turned on (see
       curs_attr(3)). Otherwise, the default character in the  following  list
       is  stored  in the variable. The variable names are consistent with the
       VT100 nomenclature.

       ─────────────────────────────────────────────────
       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
       ─────────────────────────────────────────────────

NOTES
       The header file	<curses.h>  automatically  includes  the  header  file
       <stdio.h>.

       Note that addwch, mvaddwch, mvwaddwch, and echowchar may be macros.

       The routines described on this reference page are among the MNLS Curses
       functions that are not included in the X/Open Curses CAE specification.
       MNLS  routines  are  supported only for backward compatibility reasons.
       Use the *add_wch and *echo_wchar functions  in  new  applications  (see
       curs_add_wch(3)).

RETURN VALUES
       All routines return the integer ERR upon failure and OK upon successful
       completion, unless otherwise noted in the  preceding  routine  descrip‐
       tions.

SEE ALSO
       Functions:  curses(3),  curs_add_wch(3),	 curs_attr(3),	curs_clear(3),
       curs_inch(3), curs_outopts(3), curs_refresh(3), putwc(3)

								curs_addwch(3)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net