1*62f08720SJoerg Sonnenberger.\" $NetBSD: fputws.3,v 1.2 2003/08/07 16:43:24 agc Exp $ 2*62f08720SJoerg Sonnenberger.\" $DragonFly: src/lib/libc/stdio/fputws.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.\" @(#)fputs.3 8.1 (Berkeley) 6/4/93 36*62f08720SJoerg Sonnenberger.\" 37*62f08720SJoerg Sonnenberger.\" Original version ID: 38*62f08720SJoerg Sonnenberger.\" FreeBSD: src/lib/libc/stdio/fputs.3,v 1.8 2001/10/01 16:08:59 ru Exp 39*62f08720SJoerg Sonnenberger.\" FreeBSD: src/lib/libc/stdio/fputws.c,v 1.4 2002/09/20 13:25:40 tjr Exp 40*62f08720SJoerg Sonnenberger.\" 41*62f08720SJoerg Sonnenberger.Dd August 6, 2002 42*62f08720SJoerg Sonnenberger.Dt FPUTWS 3 43*62f08720SJoerg Sonnenberger.Os 44*62f08720SJoerg Sonnenberger.Sh NAME 45*62f08720SJoerg Sonnenberger.Nm fputws 46*62f08720SJoerg Sonnenberger.Nd output a line of wide characters to a stream 47*62f08720SJoerg Sonnenberger.Sh LIBRARY 48*62f08720SJoerg Sonnenberger.Lb libc 49*62f08720SJoerg Sonnenberger.Sh SYNOPSIS 50*62f08720SJoerg Sonnenberger.In stdio.h 51*62f08720SJoerg Sonnenberger.In wchar.h 52*62f08720SJoerg Sonnenberger.Ft int 53*62f08720SJoerg Sonnenberger.Fn fputws "const wchar_t * restrict ws" "FILE * restrict fp" 54*62f08720SJoerg Sonnenberger.Sh DESCRIPTION 55*62f08720SJoerg SonnenbergerThe 56*62f08720SJoerg Sonnenberger.Fn fputws 57*62f08720SJoerg Sonnenbergerfunction writes the wide character string pointed to by 58*62f08720SJoerg Sonnenberger.Fa ws 59*62f08720SJoerg Sonnenbergerto the stream pointed to by 60*62f08720SJoerg Sonnenberger.Fa fp . 61*62f08720SJoerg Sonnenberger.Sh RETURN VALUES 62*62f08720SJoerg SonnenbergerThe 63*62f08720SJoerg Sonnenberger.Fn fputws 64*62f08720SJoerg Sonnenbergerfunction 65*62f08720SJoerg Sonnenbergerreturns 0 on success and \-1 on error. 66*62f08720SJoerg Sonnenberger.Sh ERRORS 67*62f08720SJoerg Sonnenberger.Bl -tag -width Er 68*62f08720SJoerg Sonnenberger.It Bq Er EBADF 69*62f08720SJoerg SonnenbergerThe 70*62f08720SJoerg Sonnenberger.Fa fp 71*62f08720SJoerg Sonnenbergerargument supplied 72*62f08720SJoerg Sonnenbergeris not a writable stream. 73*62f08720SJoerg Sonnenberger.El 74*62f08720SJoerg Sonnenberger.Pp 75*62f08720SJoerg SonnenbergerThe 76*62f08720SJoerg Sonnenberger.Fn fputws 77*62f08720SJoerg Sonnenbergerfunction may also fail and set 78*62f08720SJoerg Sonnenberger.Va errno 79*62f08720SJoerg Sonnenbergerfor any of the errors specified for the routine 80*62f08720SJoerg Sonnenberger.Xr write 2 . 81*62f08720SJoerg Sonnenberger.Sh SEE ALSO 82*62f08720SJoerg Sonnenberger.Xr ferror 3 , 83*62f08720SJoerg Sonnenberger.Xr fputs 3 , 84*62f08720SJoerg Sonnenberger.Xr putwc 3 , 85*62f08720SJoerg Sonnenberger.Xr stdio 3 86*62f08720SJoerg Sonnenberger.Sh STANDARDS 87*62f08720SJoerg SonnenbergerThe 88*62f08720SJoerg Sonnenberger.Fn fputws 89*62f08720SJoerg Sonnenbergerfunction conforms to 90*62f08720SJoerg Sonnenberger.St -p1003.1-2001 . 91