NAME    [Toc]    [Back]

       curs_chgat, chgat, wchgat, mvchgat, mvwchgat - Change renditions
 of characters in a Curses window

SYNOPSIS    [Toc]    [Back]

       #include <curses.h>

       int chgat(
               int n,
               attr_t attr,
               short color_pair,
               const void *opts ); int wchgat(
               WINDOW *win,
               int n,
               attr_t attr,
               short color_pair,
               const void *opts ); int mvchgat(
               int y,
               int x,
               int n,
               attr_t attr,
               short color_pair,
               const void *opts ); int mvwchgat(
               WINDOW *win,
               int y,
               int x,
               int n,
               attr_t attr,
               short color_pair,
               const void *opts );

LIBRARY    [Toc]    [Back]

       Curses Library (libcurses)

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       chgat, wchgat, mvchgat, mvwchgat:  XCURSES4.2

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

DESCRIPTION    [Toc]    [Back]

       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_pair  as  in
       setcchar.

       These  functions  do not update the cursor and 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 future use. Currently,
       the application must provide a null pointer as opts.

NOTES    [Toc]    [Back]

       The header  file  <curses.h>  automatically  includes  the
       header file <stdio.h>.

       Note that chgat, mvchgat, and mvwchgat may be macros.

RETURN VALUES    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

       Functions: curses(3), curs_getcchar(3)

       Others: standards(5)



                                                    curs_chgat(3)