setcchar(3curses)

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

Synopsis

cc [options] file -lcurses

#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(3curses) 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 release. Currently, the application must provide a null pointer as opts.

Return value

Upon successful completion, setcchar(3curses) returns OK. Otherwise, it returns ERR.

Errors

No errors are defined.

Standards Conformance

The Single UNIX Specification, Version 2; The Open Group.

References

``Characters'', attroff(3curses), can_change_color(3curses), getcchar(3curses), curses(4)