1setcchar(3XCURSES)      X/Open Curses Library Functions     setcchar(3XCURSES)
2
3
4

NAME

6       setcchar  - set a cchar_t type character from a wide character and ren‐
7       dition
8

SYNOPSIS

10       cc [ flag... ] file... -I /usr/xpg4/include  -L  /usr/xpg4/lib \
11        -R  /usr/xpg4/lib  -lcurses  [ library... ]
12
13       c89 [ flag... ] file... -lcurses [ library... ]
14
15       #include <curses.h>
16
17       int setcchar(cchar_t *wcval, const wchar_t *wch, const attr_t attrs,
18            short color_pair, const void *opts);
19
20

PARAMETERS

22       wcval         Is a pointer to a location where a cchar_t character (and
23                     its  rendition) can be stored.
24
25
26       wch           Is a pointer to a wide character.
27
28
29       attrs         Is  the  set  of  attributes  to apply to wch in creating
30                     wcval.
31
32
33       color_pair    Is the color pair to apply to wch in creating wcval.
34
35
36       opts          Is reserved for future use. Currently,  this  must  be  a
37                     null pointer.
38
39

DESCRIPTION

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

RETURN VALUES

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

ERRORS

51       None.
52

ATTRIBUTES

54       See attributes(5) for descriptions of the following attributes:
55
56
57
58
59       ┌─────────────────────────────┬─────────────────────────────┐
60       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
61       ├─────────────────────────────┼─────────────────────────────┤
62       │Interface Stability          │Standard                     │
63       ├─────────────────────────────┼─────────────────────────────┤
64       │MT-Level                     │Unsafe                       │
65       └─────────────────────────────┴─────────────────────────────┘
66

SEE ALSO

68       attroff(3XCURSES),    can_change_color(3XCURSES),   getcchar(3XCURSES),
69       libcurses(3XCURSES), attributes(5), standards(5)
70
71
72
73SunOS 5.11                        5 Jun 2002                setcchar(3XCURSES)
Impressum