CURSADDWCH(3X-SVR4)RISC/os Reference Manual CURSADDWCH(3X-SVR4)



NAME
     curs_addwch:  addwch, waddwch, mvaddwch, mvwaddwch,
          echowchar, wechowchar - add a wchar_t character (with
          attributes) to a curses window 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);

DESCRIPTION
     With the addwch, waddwch, mvaddwch and mvwaddwch routines,
     the character wch which is holding a wchar_t character 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 putwchar in the C multi-
     byte library.  At the right margin, an automatic newline is
     performed.  At the bottom of the scrolling region, if scrol-
     lok is enabled, the scrolling region is scrolled up one
     line.

     If wch 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 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 character.

     Video attributes can be combined with a wchar_t 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 inwch and addwch.)  [see standout, predefined
     video attribute constants, on the curs_attr(3X) 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 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.




                        Printed 11/19/92                   Page 1

CURSADDWCH(3X-SVR4)RISC/os Reference Manual CURSADDWCH(3X-SVR4)



   Line Graphics
     The following variables may be used to add line drawing
     characters to the screen with routines of the addwch family.
     When variables are defined for the terminal, the
     A_ALTCHARSET bit is turned on [see curs_attr(3X)].  Other-
     wise, the default character listed below is stored in the
     variable.  The names chosen 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
          _________________________________________________
          Name            Default   Glyph Description
          _________________________________________________
          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
     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 descrip-
     tions.

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




 Page 2                 Printed 11/19/92

CURSADDWCH(3X-SVR4)RISC/os Reference Manual CURSADDWCH(3X-SVR4)



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

SEE ALSO
     curses(3X), curs_attr(3X), curs_clear(3X), curs_inwch(3X),
     curs_outopts(3X), curs_refresh(3X) putwc(3W).

















































                        Printed 11/19/92                   Page 3