setcchar.3x (2010 09)

s
setcchar(3X) setcchar(3X)
(ENHANCED CURSES)
NAME
setcchar — set cchar_t from a wide character string and rendition
SYNOPSIS
#include <curses.h>
int setcchar(cchar_t *wcval, const wchar_t *wch, const attr_t attrs,
short color_pair, const void *opts);
DESCRIPTION
The setcchar() function initialises the object pointed to by wcval according to the character attributes
in attrs , the colour pair in color_pair and the wide character string pointed to by wch.
The opts argument is reserved for definition in a future edition of this document. Currently, the applica-
tion must provide a null pointer as opts.
RETURN VALUE
Upon successful completion,
setcchar() returns OK. Otherwise, it returns ERR.
ERRORS
No errors are defined.
SEE ALSO
attroff(3X), can_change_color(3X), getcchar(3X), curses_intro(3X), see section Characters , <curses.h>.
CHANGE HISTORY
First released in X/Open Curses, Issue 4.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1