Go to main content

man pages section 3: Curses Library Functions

Exit Print View

Updated: July 2017
 
 

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(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
Unsafe
Standard

See Also

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