'\" te
.\"  Copyright (c) 1990, 1995 by Mortice Kern Systems Inc.  All Rights Reserved  Portions Copyright (c) 1996, Sun Microsystems, Inc.  All Rights Reserved
.TH setcchar 3XCURSES "5 Jun 2002" "SunOS 5.11" "X/Open Curses Library Functions"
.SH NAME
setcchar \- set a cchar_t type character from a wide character and rendition
.SH SYNOPSIS
.LP
.nf
\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-I\fR /usr/xpg4/include \fB -L \fR /usr/xpg4/lib \e
\fB -R \fR /usr/xpg4/lib \fB -lcurses \fR [ \fIlibrary\fR... ]

\fBc89\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lcurses\fR [ \fIlibrary\fR... ]

#include <curses.h>

\fBint\fR \fBsetcchar\fR(\fBcchar_t *\fR\fIwcval\fR, \fBconst wchar_t *\fR\fIwch\fR, \fBconst attr_t\fR \fIattrs\fR,
     \fBshort\fR \fIcolor_pair\fR, \fBconst void *\fR\fIopts\fR);
.fi

.SH PARAMETERS
.sp
.ne 2
.mk
.na
\fB\fIwcval\fR\fR
.ad
.RS 14n
.rt  
Is a pointer to a location where a \fBcchar_t\fR character (and its  rendition) can be stored.
.RE

.sp
.ne 2
.mk
.na
\fB\fIwch\fR\fR
.ad
.RS 14n
.rt  
Is a pointer to a wide character.
.RE

.sp
.ne 2
.mk
.na
\fB\fIattrs\fR\fR
.ad
.RS 14n
.rt  
Is the set of attributes to apply to \fIwch\fR in creating \fIwcval\fR.
.RE

.sp
.ne 2
.mk
.na
\fB\fIcolor_pair\fR\fR
.ad
.RS 14n
.rt  
Is the color pair to apply to \fIwch\fR in creating \fIwcval\fR.
.RE

.sp
.ne 2
.mk
.na
\fB\fIopts\fR\fR
.ad
.RS 14n
.rt  
Is reserved for future use. Currently, this must be a null pointer.
.RE

.SH DESCRIPTION
.sp
.LP
The \fBsetcchar()\fR function takes the wide character pointed to by \fIwch\fR, combines it with the attributes indicated by \fIattrs\fR and the color pair indicated by \fIcolor_pair\fR and stores the result in the object pointed to by \fIwcval\fR.
.SH RETURN VALUES
.sp
.LP
On success, the \fBsetcchar()\fR function returns \fBOK\fR. Otherwise, it returns \fBERR\fR.
.SH ERRORS
.sp
.LP
None.
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Interface StabilityCommitted
_
MT-LevelUnsafe
_
StandardSee \fBstandards\fR(5).
.TE

.SH SEE ALSO
.sp
.LP
\fBattroff\fR(3XCURSES), \fBcan_change_color\fR(3XCURSES), \fBgetcchar\fR(3XCURSES), \fBlibcurses\fR(3XCURSES), \fBattributes\fR(5), \fBstandards\fR(5)