.\"***************************************************************************
-.\" Copyright 2019-2020,2021 Thomas E. Dickey *
+.\" Copyright 2019-2021,2023 Thomas E. Dickey *
.\" Copyright 2001-2015,2017 Free Software Foundation, Inc. *
.\" *
.\" Permission is hereby granted, free of charge, to any person obtaining a *
.\" authorization. *
.\"***************************************************************************
.\"
-.\" $Id: curs_getcchar.3x,v 1.28 2021/12/25 20:35:03 tom Exp $
-.TH curs_getcchar 3X 2021-12-25 "ncurses 6.4" "Library calls"
+.\" $Id: curs_getcchar.3x,v 1.31 2023/07/01 15:43:20 tom Exp $
+.TH curs_getcchar 3X 2023-07-01 "ncurses 6.4" "Library calls"
.de bP
.ie n .IP \(bu 4
.el .IP \(bu 2
.B " const void *\fIopts\fP );"
.SH DESCRIPTION
.SS getcchar
-.PP
The \fBgetcchar\fP function gets a wide-character string
and rendition from a \fBcchar_t\fP argument.
When \fIwch\fP is not a null pointer,
or
\fIcolor_pair\fP
.SS setcchar
-.PP
The \fBsetcchar\fP function initializes the location pointed to by \fIwcval\fP
by using:
.bP
The string may contain a single control character instead.
In that case, no nonspacing characters are allowed.
.SH EXTENSIONS
-.PP
X/Open Curses documents the \fIopts\fP argument as reserved for future use,
saying that it must be null.
This implementation
and used to retrieve the color pair as an \fBint\fP value,
in addition retrieving it via the standard pointer to \fBshort\fP parameter.
.SH NOTES
-.PP
The \fIwcval\fP argument may be a value generated by a call to
\fBsetcchar\fP or by a function that has a \fBcchar_t\fP output argument.
If \fIwcval\fP is constructed by any other means, the effect is unspecified.
.SH RETURN VALUE
-.PP
When \fIwch\fP is a null pointer,
\fBgetcchar\fP returns the number of wide characters referenced by
\fIwcval\fP,
Unicode does not limit the (analogous) number of combining characters,
so some applications may be affected.
.SH SEE ALSO
-.PP
Functions:
\fBcurs_attr\fP(3X),
\fBcurs_color\fP(3X),