chgat(3curses)

chgat -- change renditions of characters in a window

Synopsis

cc [options] file -lcurses

#include <curses.h>

int chgat(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);

int wchgat(WINDOW *win, int n, attr_t 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 -1), starting at the current or specified cursor position. The attributes and colors are specified by attr and color as for setcchar(3curses).

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.

Standards Conformance

The Single UNIX Specification, Version 2; The Open Group.

References

setcchar(3curses), curses(4)