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

개요

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

addch(3xcurses)

X/Open Curses Library Functions                                addch(3XCURSES)



NAME
       addch,  mvaddch, mvwaddch, waddch - add a character (with rendition) to
       a window

SYNOPSIS
       cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib \
       -R /usr/xpg4/lib -lcurses [ library... ]

       c89 [ flag... ] file... -lcurses [ library ... ]

       #include <curses.h>

       int addch(const chtype ch);


       int mvaddch(int y, int x, const chtype ch);


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


       int waddch(WINDOW *win, const chtype ch);

DESCRIPTION
        The addch() function writes a character to the stdscr  window  at  the
       current  cursor  position. The mvaddch() and mvwaddch() functions write
       the character to the position indicated by the x (column) and  y  (row)
       parameters.  The  mvaddch() function writes the character to the stdscr
       window, while mvwaddch() writes the character to the  window  specified
       by  win.  The waddch() function is identical to addch(), but writes the
       character to the window specified by win.


       These functions advance the cursor after writing the character. Charac‐
       ters  that do not fit on the end of the current line are wrapped to the
       beginning of the next line unless the current line is the last line  of
       the  window  and  scrolling  is disabled. In that situation, characters
       which extend beyond the end of the line are discarded.


       When ch is a backspace, carriage return, newline, or tab, X/Open Curses
       moves  the cursor appropriately. Each tab character moves the cursor to
       the next tab stop. By default, tab stops  occur  every  eight  columns.
       When  ch  is a control character other than backspace, carriage return,
       newline, or tab, it is written using ^x notation, where x is  a  print‐
       able  character.  When  X/Open  Curses  writes ch to the last character
       position on a line, it automatically generates a newline.  When  ch  is
       written to the last character position of a scrolling region and scrol‐
       lok() is enabled, X/Open Curses scrolls the  scrolling  region  up  one
       line (see clearok(3XCURSES)).

PARAMETERS
       wchstr    Is  a  pointer to the cchar_t string to be copied to the win‐
                 dow.


       n         Is the maximum number of characters to be copied from wchstr.
                 If  n is less than 0, the entire string is written or as much
                 of it as fits on the line.


       y         Is the y (row) coordinate of the starting position of  wchstr
                 in the window.


       x         Is the x (column) coordinate of the starting position of wch‐
                 str in the window.


       win       Is a pointer to the window to  which  the  string  is  to  be
                 copied.


RETURN VALUES
       On success, these functions return OK. Otherwise, they return ERR.

ERRORS
       None.

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 _ Interface StabilityCommitted _ MT-LevelUnsafe  _  Stan‐
       dardSee standards(7).


SEE ALSO
       attroff(3XCURSES),        bkgdset(3XCURSES),        doupdate(3XCURSES),
       inch(3XCURSES),  insch(3XCURSES),  libcurses(3XCURSES),   nl(3XCURSES),
       printw(3XCURSES),   scrl(3XCURSES),   scrollok(3XCURSES),  terminfo(5),
       attributes(7), standards(7)



Oracle Solaris 11.4               5 Jun 2002                   addch(3XCURSES)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3