addch(3curses) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

addch(3curses)

curs_addch(3CURSES)        Curses Library Functions        curs_addch(3CURSES)

NAME
       curs_addch, 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 <curses.h>

       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() routines, 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 func‐
       tion is similar to that of putchar(). 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 ch is a tab, newline, or backspace, the cursor  is  moved  appropri‐
       ately  within  the window. A newline also does a clrtoeol() before mov‐
       ing. Tabs are considered to be at every eighth column. If ch is another
       control character, it is drawn in the ^X notation. Calling winch()  af‐
       ter  adding  a control character does not return the control character,
       but instead returns the representation of the  control  character.  See
       curs_inch(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 inch() and addch().) (see standout(), predefined
       video attribute constants, on the curs_attr(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-con‐
       trol 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  de‐
       fined  for  the  terminal,  the  A_ALTCHARSET  bit  is  turned  on (see
       curs_attr(3CURSES)). Otherwise, the default character listed  below  is
       stored  in the variable. The names chosen are consistent with the VT100
       nomenclature.

       tab()  box;  lw(1.83i)  |lw(1.25i)  |lw(2.42i)   lw(1.83i)   |lw(1.25i)
       |lw(2.42i)  NameDefaultGlyph 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_DIA‐
       MOND+diamond  _ ACS_CKBOARD:checker board (stipple) _ ACS_DEGREE'degree
       symbol _ ACS_PLMINUS#plus/minus _ ACS_BULLETobullet _  ACS_LARROW<arrow
       pointing  left  _  ACS_RARROW>arrow  pointing  right _ ACS_DARROWvarrow
       pointing down _  ACS_UARROW^arrow  pointing  up  _  ACS_BOARD#board  of
       squares _ ACS_LANTERN#lantern symbol _ ACS_BLOCK #solid square block


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

ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE VALUE _ MT-LevelUnsafe


SEE ALSO
       curs_refresh(3CURSES),     curs_attr(3CURSES),     curs_clear(3CURSES),
       curs_inch(3CURSES), curs_outopts(3CURSES),  curses(3CURSES),  putc(3C),
       attributes(7)

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


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

Oracle Solaris 11.4               31 Dec 1996              curs_addch(3CURSES)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3