chgat(3X)                                                         chgat(3X)

NAME
     chgat, mvchgat, mvwchgat, wchgat - change renditions of characters in
     a window

SYNOPSIS
     cc [flag ...] file ... -lcurses [library ...]

     #include <curses.h>

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

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

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

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

DESCRIPTION
     These functions change the renditions of the next n characters in the
     current or specified window (or of the remaining characters on the
     current or specified line, if n is -), starting at the current or
     specified cursor position. The attributes and colors are specified by
     attr and color as for setcchar().

     These functions do not update the cursor. These functions do not per-
     form wrapping.

     A value of n that is greater than the remaining characters on a line
     is not an error.

     The opts argument is reserved for definition in a future edition of
     this document. Currently, the application must provide a null pointer
     as opts.

RETURN VALUE
     Upon successful completion, these functions return OK. Otherwise, they
     return ERR.

ERRORS
     No errors are defined.

SEE ALSO
     curses(3X), setcchar(3X), curses(5).









Page 1                       Reliant UNIX 5.44                Printed 11/98