SETCCHAR(3XCURSES) X/Open Curses Library Functions SETCCHAR(3XCURSES)

NAME

setcchar - set a cchar_t type character from a wide character and
rendition

SYNOPSIS

cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib \
-R /usr/xpg4/lib -lcurses [ library... ]

c89 [ flag... ] file... -lcurses [ library... ]

#include <curses.h>

int setcchar(cchar_t *wcval, const wchar_t *wch, const attr_t attrs,
short color_pair, const void *opts);

PARAMETERS

wcval
Is a pointer to a location where a cchar_t character
(and its rendition) can be stored.


wch
Is a pointer to a wide character.


attrs
Is the set of attributes to apply to wch in creating
wcval.


color_pair
Is the color pair to apply to wch in creating wcval.


opts
Is reserved for future use. Currently, this must be a
null pointer.

DESCRIPTION

The setcchar() function takes the wide character pointed to by wch,
combines it with the attributes indicated by attrs and the color pair
indicated by color_pair and stores the result in the object pointed
to by wcval.

RETURN VALUES

On success, the setcchar() function returns OK. Otherwise, it returns
ERR.

ERRORS

None.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | Unsafe |
+--------------------+-----------------+

SEE ALSO

attroff(3XCURSES), can_change_color(3XCURSES), getcchar(3XCURSES),
libcurses(3XCURSES), attributes(7), standards(7)

June 5, 2002 SETCCHAR(3XCURSES)