Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

addch(3cur) [ultrix man page]

addch(3cur)															       addch(3cur)

Name
       addch, waddch, mvaddch, mvwaddch - add character to window

Syntax
       #include <cursesX.h>

       int addch(ch)
       chtype ch;

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

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

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

Description
       The  routine inserts the character into the default window at the current cursor position and the window cursor is advanced.  The character
       is of the type which is defined in the header file, as containing both data and attributes.

       The routine inserts the character into the specified window at the current cursor position.  The cursor position is advanced.

       The routine moves the cursor to the specified (y, x) position and inserts the character into the default window.  The  cursor  position	is
       advanced after the character has been inserted.

       The  routine moves the cursor to the specified (y, x) position and inserts the character into the specified window.  The cursor position is
       advanced after the character has been inserted.

       All these routines are similar to The following information applies to all the routines.

       If the cursor moves on to the right margin, an automatic newline is performed.  If is enabled, and a character is added to the bottom right
       corner of the screen, the scrolling region will be scrolled up one line.  If scrolling is not allowed, ERR will be returned.

       If  is  a  tab,	newline,  or  backspace, the cursor will be moved appropriately within the window.  If is a newline, the routine is called
       before the cursor is moved to the beginning of the next line.  If newline mapping is off, the cursor will be moved to the  next	line,  but
       the  x  coordinate  will  be unchanged.	If is a tab the cursor is moved to the next tab position within the window.  If is another control
       character, it will be drawn in the ^X notation.	Calling the routine after adding a control character returns  the  representation  of  the
       control character, not the control character.

       Video  attributes can be combined with a character by or-ing them into the parameter.  This will result in these attributes being set.  The
       intent here is that text, including attributes, can be copied from one place to another using and For further information, see

       The and routines are macros.

Return Values
       The and functions return OK on success and ERR on error.

See Also
       clrtoeol(3cur), inch(3cur), scrollok(3cur), standout(3cur), putchar(3s)

																       addch(3cur)

Check Out this Related Man Page

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 std- scr 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. Characters 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, char- acters 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 printable 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 scrollok() 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 window. 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 wchstr 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(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ |MT-Level |Unsafe | +-----------------------------+-----------------------------+ SEE ALSO
attroff(3XCURSES), bkgdset(3XCURSES), doupdate(3XCURSES), inch(3XCURSES), insch(3XCURSES), libcurses(3XCURSES), nl(3XCURSES), printw(3XCURSES), scrollok(3XCURSES), scrl(3XCURSES), terminfo(4), attributes(5), standards(5) SunOS 5.11 5 Jun 2002 addch(3XCURSES)
Man Page

Featured Tech Videos