*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> waddch (3)              
Title
Content
Arch
Section
 

curs_addch(3)

Contents


NAME    [Toc]    [Back]

       curs_addch,  addch,  waddch,  mvaddch, mvwaddch, echochar,
       wechochar - Add a character (with attributes) to a  Curses
       window and advance the cursor

SYNOPSIS    [Toc]    [Back]

       #include <curses.h>

       int addch(
               const chtype ch ); int waddch(
               WINDOW *win,
               const chtype ch ); int mvaddch(
               int y,
               int x,
               const chtype ch ); int mvwaddch(
               WINDOW *win,
               int y,
               int x,
               const chtype ch ); int echochar(
               const chtype ch ); int wechochar(
               WINDOW *win,
               const chtype ch );

LIBRARY    [Toc]    [Back]

       Curses Library (libcurses)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       addch,    waddch,     mvaddch,     mvwaddch,     echochar,
       wechochar:  XCURSES4.2

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

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 the putchar
       function. 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, these functions
       move the cursor appropriately within the window. A newline
       also  performs 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 in a
       parameter through an inclusive OR operation.  This  operation
  also  sets  these attributes. (The intent here is to
       allow text, including attributes, to be  copied  from  one
       place to another by using inch and addch.  See the discussion
 on standout, predefined video attribute constants, in
       the curs_attr(3) reference 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 may  be  realized
 by using these routines instead of their equivalents.

   Line Graphics    [Toc]    [Back]
       The following variables may be used with routines  of  the
       addch 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  specified  in  the  following
       list is stored in the variable. The names chosen for variables
 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    [Toc]    [Back]

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

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

RETURN VALUES    [Toc]    [Back]

       All routines return the integer ERR upon  failure  and  OK
       upon successful completion.






SEE ALSO    [Toc]    [Back]

      
      
       Functions:    curses(3),    curs_attr(3),   curs_clear(3),
       curs_inch(3), curs_outopts(3), curs_refresh(3), putc(3)

       Others: standards(5)



                                                    curs_addch(3)
[ Back ]
 Similar pages
Name OS Title
waddch OpenBSD add a character (with attributes) to a curses window, then advance the cursor
echochar FreeBSD add a character (with attributes) to a curses window, then advance the cursor
mvaddch FreeBSD add a character (with attributes) to a curses window, then advance the cursor
waddch FreeBSD add a character (with attributes) to a curses window, then advance the cursor
mvwaddch FreeBSD add a character (with attributes) to a curses window, then advance the cursor
curs_addch FreeBSD add a character (with attributes) to a curses window, then advance the cursor
mvaddch OpenBSD add a character (with attributes) to a curses window, then advance the cursor
mvwaddch OpenBSD add a character (with attributes) to a curses window, then advance the cursor
addch FreeBSD add a character (with attributes) to a curses window, then advance the cursor
echochar OpenBSD add a character (with attributes) to a curses window, then advance the cursor
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service