2 * Copyright (c) 2002-2004 Tim J. Robbins.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29 <<fputws>>, <<fputws_unlocked>>---write a wide character string in a file or stream
42 int fputws(const wchar_t *__restrict <[ws]>, FILE *__restrict <[fp]>);
46 int fputws_unlocked(const wchar_t *__restrict <[ws]>, FILE *__restrict <[fp]>);
49 int _fputws_r(struct _reent *<[ptr]>, const wchar_t *<[ws]>,
53 int _fputws_unlocked_r(struct _reent *<[ptr]>, const wchar_t *<[ws]>,
57 <<fputws>> writes the wide character string at <[ws]> (but without the
58 trailing null) to the file or stream identified by <[fp]>.
60 <<fputws_unlocked>> is a non-thread-safe version of <<fputws>>.
61 <<fputws_unlocked>> may only safely be used within a scope
62 protected by flockfile() (or ftrylockfile()) and funlockfile(). This
63 function may safely be used in a multi-threaded program if and only
64 if they are called while the invoking thread owns the (FILE *)
65 object, as is the case after a successful call to the flockfile() or
66 ftrylockfile() functions. If threads are disabled, then
67 <<fputws_unlocked>> is equivalent to <<fputws>>.
69 <<_fputws_r>> and <<_fputws_unlocked_r>> are simply reentrant versions of the
70 above that take an additional reentrant struct pointer argument: <[ptr]>.
73 If successful, the result is a non-negative integer; otherwise, the result
74 is <<-1>> to indicate an error.
77 <<fputws>> is required by C99 and POSIX.1-2001.
79 <<fputws_unlocked>> is a GNU extension.
91 #ifdef __IMPL_UNLOCKED__
92 #define _fputws_r _fputws_unlocked_r
93 #define fputws fputws_unlocked
97 _fputws_r (struct _reent
*ptr
,
103 #ifdef _FVWRITE_IN_STREAMIO
107 _newlib_flockfile_start (fp
);
108 if (ORIENT (fp
, 1) != 1)
110 if (cantwrite (ptr
, fp
) != 0)
117 nbytes
= _wcsrtombs_r(ptr
, buf
, &ws
, sizeof (buf
), &fp
->_mbstate
);
118 if (nbytes
== (size_t) -1)
120 iov
.iov_len
= uio
.uio_resid
= nbytes
;
121 if (__sfvwrite_r(ptr
, fp
, &uio
) != 0)
125 _newlib_flockfile_exit (fp
);
129 _newlib_flockfile_end (fp
);
132 _newlib_flockfile_start (fp
);
133 if (cantwrite (ptr
, fp
) != 0)
139 nbytes
= _wcsrtombs_r (ptr
, buf
, &ws
, sizeof (buf
), &fp
->_mbstate
);
140 if (nbytes
== (size_t) -1)
144 if (__swputc_r (ptr
, buf
[i
], fp
) == EOF
)
150 _newlib_flockfile_exit (fp
);
154 _newlib_flockfile_end (fp
);
160 fputws (const wchar_t *__restrict ws
,
163 struct _reent
*reent
= _REENT
;
165 CHECK_INIT (reent
, fp
);
166 return _fputws_r (reent
, ws
, fp
);