Content-type: text/html Man page of curs_chgat

curs_chgat

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

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

SYNOPSIS

#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

Curses Library (libcurses)
 

STANDARDS

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

chgat, wchgat, mvchgat, mvwchgat:  XPG4-UNIX

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

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_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

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

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

RETURN VALUES

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

SEE ALSO

Functions: curses(3), curs_getcchar(3)

Others: standards(5)


 

Index

NAME
SYNOPSIS
LIBRARY
STANDARDS
DESCRIPTION
NOTES
RETURN VALUES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:41:05 GMT, October 02, 2010