CURSES_CCHAR(3) | Library Functions Manual | CURSES_CCHAR(3) |
curses_cchar
, getcchar
,
setcchar
—
#include <curses.h>
int
getcchar
(const cchar_t *wcval,
wchar_t *wch, attr_t *attrs,
short *color_pair, void
*opts);
int
setcchar
(cchar_t *wcval,
const wchar_t *wch, const attr_t
attrs, short color_pair, const
void *opts);
Objects of type cchar_t can be manipulated
using the getcchar
and
setcchar
functions. Both these functions take as
their last parameter the opts argument which is
reserved for future extensions. Currently, the application must provide a
null pointer as opts.
When the getcchar
function is called with
non-null wch it extracts the information from the
wcval object. The string of wide characters in
wcval is copied to the wch
array. The attributes are stored in attrs and the
color pair is stored in color_pair. In this case it
returns OK
upon successful completion, and
ERR
otherwise.
When getcchar
is called with null
wch it doesn't store any information but returns the
number of wide characters referenced by wcval,
including the null terminator.
setcchar
initializes
wcval with the wide-character string
wch, attributes attrs, and color
pair color_pair.
getchar
called with null wch
returns the the number of wide characters referenced by
wcval, including the null terminator.
Otherwise these functions return one of the following values:
OK
ERR
Wide characters support appeared in NetBSD 5.0.
November 19, 2018 | NetBSD 9.2 |