SETCCHAR(3XCURSES)SETCCHAR(3XCURSES)NAMEsetcchar - set a cchar_t type character from a wide character and ren‐
dition
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(5) for descriptions of the following attributes:
┌────────────────────┬─────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼─────────────────┤
│Interface Stability │ Standard │
├────────────────────┼─────────────────┤
│MT-Level │ Unsafe │
└────────────────────┴─────────────────┘
SEE ALSOattroff(3XCURSES), can_change_color(3XCURSES), getcchar(3XCURSES),
libcurses(3XCURSES), attributes(5), standards(5)
Jun 5, 2002 SETCCHAR(3XCURSES)