1*62f08720SJoerg Sonnenberger.\" $NetBSD: putwc.3,v 1.8 2004/01/24 16:59:30 wiz Exp $ 2*62f08720SJoerg Sonnenberger.\" $DragonFly: src/lib/libc/stdio/putwc.3,v 1.1 2005/07/25 00:37:41 joerg Exp $ 3*62f08720SJoerg Sonnenberger.\" 4*62f08720SJoerg Sonnenberger.\" Copyright (c) 1990, 1991, 1993 5*62f08720SJoerg Sonnenberger.\" The Regents of the University of California. All rights reserved. 6*62f08720SJoerg Sonnenberger.\" 7*62f08720SJoerg Sonnenberger.\" This code is derived from software contributed to Berkeley by 8*62f08720SJoerg Sonnenberger.\" Chris Torek and the American National Standards Committee X3, 9*62f08720SJoerg Sonnenberger.\" on Information Processing Systems. 10*62f08720SJoerg Sonnenberger.\" 11*62f08720SJoerg Sonnenberger.\" Redistribution and use in source and binary forms, with or without 12*62f08720SJoerg Sonnenberger.\" modification, are permitted provided that the following conditions 13*62f08720SJoerg Sonnenberger.\" are met: 14*62f08720SJoerg Sonnenberger.\" 1. Redistributions of source code must retain the above copyright 15*62f08720SJoerg Sonnenberger.\" notice, this list of conditions and the following disclaimer. 16*62f08720SJoerg Sonnenberger.\" 2. Redistributions in binary form must reproduce the above copyright 17*62f08720SJoerg Sonnenberger.\" notice, this list of conditions and the following disclaimer in the 18*62f08720SJoerg Sonnenberger.\" documentation and/or other materials provided with the distribution. 19*62f08720SJoerg Sonnenberger.\" 3. Neither the name of the University nor the names of its contributors 20*62f08720SJoerg Sonnenberger.\" may be used to endorse or promote products derived from this software 21*62f08720SJoerg Sonnenberger.\" without specific prior written permission. 22*62f08720SJoerg Sonnenberger.\" 23*62f08720SJoerg Sonnenberger.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 24*62f08720SJoerg Sonnenberger.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 25*62f08720SJoerg Sonnenberger.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 26*62f08720SJoerg Sonnenberger.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 27*62f08720SJoerg Sonnenberger.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 28*62f08720SJoerg Sonnenberger.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 29*62f08720SJoerg Sonnenberger.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 30*62f08720SJoerg Sonnenberger.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 31*62f08720SJoerg Sonnenberger.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 32*62f08720SJoerg Sonnenberger.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 33*62f08720SJoerg Sonnenberger.\" SUCH DAMAGE. 34*62f08720SJoerg Sonnenberger.\" 35*62f08720SJoerg Sonnenberger.\" @(#)putc.3 8.1 (Berkeley) 6/4/93 36*62f08720SJoerg Sonnenberger.\" 37*62f08720SJoerg Sonnenberger.Dd October 20, 2001 38*62f08720SJoerg Sonnenberger.Dt PUTWC 3 39*62f08720SJoerg Sonnenberger.Os 40*62f08720SJoerg Sonnenberger.Sh NAME 41*62f08720SJoerg Sonnenberger.Nm fputwc , 42*62f08720SJoerg Sonnenberger.Nm putwc , 43*62f08720SJoerg Sonnenberger.Nm putwchar , 44*62f08720SJoerg Sonnenberger.Nd output a wide-character to a stream 45*62f08720SJoerg Sonnenberger.Sh LIBRARY 46*62f08720SJoerg Sonnenberger.Lb libc 47*62f08720SJoerg Sonnenberger.Sh SYNOPSIS 48*62f08720SJoerg Sonnenberger.In stdio.h 49*62f08720SJoerg Sonnenberger.In wchar.h 50*62f08720SJoerg Sonnenberger.Ft wint_t 51*62f08720SJoerg Sonnenberger.Fn fputwc "wchar_t wc" "FILE *stream" 52*62f08720SJoerg Sonnenberger.Ft wint_t 53*62f08720SJoerg Sonnenberger.Fn putwc "wchar_t wc" "FILE *stream" 54*62f08720SJoerg Sonnenberger.Ft wint_t 55*62f08720SJoerg Sonnenberger.Fn putwchar "wchar_t wc" 56*62f08720SJoerg Sonnenberger.Sh DESCRIPTION 57*62f08720SJoerg SonnenbergerThe 58*62f08720SJoerg Sonnenberger.Fn fputwc 59*62f08720SJoerg Sonnenbergerfunction 60*62f08720SJoerg Sonnenbergerwrites the wide-character 61*62f08720SJoerg Sonnenberger.Fa wc 62*62f08720SJoerg Sonnenbergerto the output stream pointed to by 63*62f08720SJoerg Sonnenberger.Fa stream . 64*62f08720SJoerg Sonnenberger.Pp 65*62f08720SJoerg Sonnenberger.Fn putwc 66*62f08720SJoerg Sonnenbergeracts essentially identically to 67*62f08720SJoerg Sonnenberger.Fn fputwc , 68*62f08720SJoerg Sonnenbergerbut is a macro that expands in-line. 69*62f08720SJoerg SonnenbergerIt may evaluate 70*62f08720SJoerg Sonnenberger.Fa stream 71*62f08720SJoerg Sonnenbergermore than once, so arguments given to 72*62f08720SJoerg Sonnenberger.Fn putwc 73*62f08720SJoerg Sonnenbergershould not be expressions with potential side effects. 74*62f08720SJoerg Sonnenberger.Pp 75*62f08720SJoerg Sonnenberger.Fn putwchar 76*62f08720SJoerg Sonnenbergeris identical to 77*62f08720SJoerg Sonnenberger.Fn putwc 78*62f08720SJoerg Sonnenbergerwith an output stream of 79*62f08720SJoerg Sonnenberger.Em stdout . 80*62f08720SJoerg Sonnenberger.Sh RETURN VALUES 81*62f08720SJoerg SonnenbergerThe functions 82*62f08720SJoerg Sonnenberger.Fn fputwc , 83*62f08720SJoerg Sonnenberger.Fn putwc , 84*62f08720SJoerg Sonnenbergerand 85*62f08720SJoerg Sonnenberger.Fn putwchar 86*62f08720SJoerg Sonnenbergerreturn the wide-character written. 87*62f08720SJoerg SonnenbergerIf an error occurs, the value 88*62f08720SJoerg Sonnenberger.Dv WEOF 89*62f08720SJoerg Sonnenbergeris returned. 90*62f08720SJoerg Sonnenberger.Sh SEE ALSO 91*62f08720SJoerg Sonnenberger.Xr ferror 3 , 92*62f08720SJoerg Sonnenberger.Xr fopen 3 , 93*62f08720SJoerg Sonnenberger.Xr getwc 3 , 94*62f08720SJoerg Sonnenberger.Xr stdio 3 95*62f08720SJoerg Sonnenberger.Sh STANDARDS 96*62f08720SJoerg SonnenbergerThe functions 97*62f08720SJoerg Sonnenberger.Fn fputwc , 98*62f08720SJoerg Sonnenberger.Fn putwc , 99*62f08720SJoerg Sonnenbergerand 100*62f08720SJoerg Sonnenberger.Fn putwchar , 101*62f08720SJoerg Sonnenbergerconform to 102*62f08720SJoerg Sonnenberger.St -isoC-99 . 103