ENHANCED CURSES

NAME

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

SYNOPSIS

#include <curses.h>

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

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

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

int wchgat(WINDOW *win, int n, attr_t attr, short color,
           void *const 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 line, if n is −1), 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 perform 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

setcchar(), <curses.h>. 

CHANGE HISTORY

First released in X/Open Curses, Issue 4. 

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996