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

개요

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

addch(3xcurses)

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 po‐
       sition 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),  at‐
       tributes(7), standards(7)

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