Updated: 2022/Sep/29

Please read Privacy Policy. It's for your privacy.


CURSES_CHGAT(3)            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.

NetBSD 10.99                     July 6, 2009                     NetBSD 10.99