netbsd man page for chgat

CURSES_CHGAT(3) 					   BSD Library Functions Manual 					   CURSES_CHGAT(3)

NAME
     chgat, wchgat, mvchgat, mvwchgat -- curses on-screen attribute manipulation routines

LIBRARY
     Curses Library (libcurses, -lcurses)

SYNOPSIS
     #include <curses.h>

     int
     chgat(int n, attr_t attr, short color, const void *opts);

     int
     wchgat(WINDOW *win, int n, attr_t attr, short color, const void *opts);

     int
     mvchgat(int y, int x, int n, attr_t attr, short color, const void *opts);

     int
     mvwchgat(WINDOW *win, int y, int x, int n, attr_t attr, short color, const void *opts);

DESCRIPTION
     These functions modify the attributes of the drawn content on stdscr or on the specified window.

     The chgat() function sets the attributes of the next n characters to attr and the color pair to color.  If n is negative or larger than the
     remainder of the line, it gets truncated.

     The wchgat() is the same as the chgat() function, excepting that the attributes are changed in the window specified by win.

     The mvchgat() and mvwchgat() functions are the same as the chgat() and wchgat() functions, respectively, excepting that they operate from the
     position specified by y, x.

     These functions do not perform wrapping.  They do not update the cursor position.

RETURN VALUES
     The functions that return an int will return one of the following values:

     OK   The function completed successfully.
     ERR  An error occurred in the function.

SEE ALSO
     curses_attributes(3)

STANDARDS
     The chgat(), wchgat(), mvchgat(), and mvwchgat() functions conform to X/Open Curses Issue 4, Version 2 (``XCURSES4.2'').

HISTORY
     The Curses package appeared in 4.0BSD.  Support for the chgat() family was added in NetBSD 6.0.

BSD
								   July 6, 2009 							       BSD