xref: /dflybsd-src/lib/libc/stdio/wprintf_l.3 (revision a4f24c1869ab98b63a76f4b2e852ce2368e87edf)
1646bb83bSSascha Wildner.\" Copyright (c) 1990, 1991, 1993
2646bb83bSSascha Wildner.\"	The Regents of the University of California.  All rights reserved.
3646bb83bSSascha Wildner.\"
4646bb83bSSascha Wildner.\" This code is derived from software contributed to Berkeley by
5646bb83bSSascha Wildner.\" Chris Torek and the American National Standards Committee X3,
6646bb83bSSascha Wildner.\" on Information Processing Systems.
7646bb83bSSascha Wildner.\"
8646bb83bSSascha Wildner.\" Redistribution and use in source and binary forms, with or without
9646bb83bSSascha Wildner.\" modification, are permitted provided that the following conditions
10646bb83bSSascha Wildner.\" are met:
11646bb83bSSascha Wildner.\" 1. Redistributions of source code must retain the above copyright
12646bb83bSSascha Wildner.\"    notice, this list of conditions and the following disclaimer.
13646bb83bSSascha Wildner.\" 2. Redistributions in binary form must reproduce the above copyright
14646bb83bSSascha Wildner.\"    notice, this list of conditions and the following disclaimer in the
15646bb83bSSascha Wildner.\"    documentation and/or other materials provided with the distribution.
16646bb83bSSascha Wildner.\" 3. Neither the name of the University nor the names of its contributors
17646bb83bSSascha Wildner.\"    may be used to endorse or promote products derived from this software
18646bb83bSSascha Wildner.\"    without specific prior written permission.
19646bb83bSSascha Wildner.\"
20646bb83bSSascha Wildner.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21646bb83bSSascha Wildner.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22646bb83bSSascha Wildner.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23646bb83bSSascha Wildner.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24646bb83bSSascha Wildner.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25646bb83bSSascha Wildner.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26646bb83bSSascha Wildner.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27646bb83bSSascha Wildner.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28646bb83bSSascha Wildner.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29646bb83bSSascha Wildner.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30646bb83bSSascha Wildner.\" SUCH DAMAGE.
31646bb83bSSascha Wildner.\"
32646bb83bSSascha Wildner.\"     @(#)printf.3	8.1 (Berkeley) 6/4/93
33646bb83bSSascha Wildner.\" $FreeBSD: head/lib/libc/stdio/wprintf.3 208027 2010-05-13 12:07:55Z uqs $
34646bb83bSSascha Wildner.\"
35646bb83bSSascha Wildner.Dd November 17, 2013
36*a4f24c18SSascha Wildner.Dt WPRINTF_L 3
37646bb83bSSascha Wildner.Os
38646bb83bSSascha Wildner.Sh NAME
39646bb83bSSascha Wildner.Nm wprintf_l ,
40646bb83bSSascha Wildner.Nm fwprintf_l ,
41646bb83bSSascha Wildner.Nm swprintf_l ,
42646bb83bSSascha Wildner.Nm vfwprintf_l ,
43646bb83bSSascha Wildner.Nm vswprintf_l ,
44646bb83bSSascha Wildner.Nm vwprintf_l
45646bb83bSSascha Wildner.Nd formatted wide character output conversion
46646bb83bSSascha Wildner.Sh LIBRARY
47646bb83bSSascha Wildner.Lb libc
48646bb83bSSascha Wildner.Sh SYNOPSIS
49646bb83bSSascha Wildner.In stdio.h
50646bb83bSSascha Wildner.In wchar.h
51646bb83bSSascha Wildner.In xlocale.h
52646bb83bSSascha Wildner.Ft int
53646bb83bSSascha Wildner.Fn fwprintf_l "FILE * restrict stream" "locale_t loc" "const wchar_t * restrict format" ...
54646bb83bSSascha Wildner.Ft int
55646bb83bSSascha Wildner.Fn swprintf_l "wchar_t * restrict ws" "size_t n" "locale_t loc" "const wchar_t * restrict format" ...
56646bb83bSSascha Wildner.Ft int
57646bb83bSSascha Wildner.Fn wprintf_l "locale_t loc" "const wchar_t * restrict format" ...
58646bb83bSSascha Wildner.In stdarg.h
59646bb83bSSascha Wildner.Ft int
60646bb83bSSascha Wildner.Fn vfwprintf_l "FILE * restrict stream" "locale_t loc" "const wchar_t * restrict format" "va_list ap"
61646bb83bSSascha Wildner.Ft int
62646bb83bSSascha Wildner.Fn vswprintf_l "wchar_t * restrict ws" "size_t n" "locale_t loc" "const wchar_t *restrict format" "va_list ap"
63646bb83bSSascha Wildner.Ft int
64646bb83bSSascha Wildner.Fn vwprintf_l "locale_t loc" "const wchar_t * restrict format" "va_list ap"
65646bb83bSSascha Wildner.Sh DESCRIPTION
66646bb83bSSascha WildnerThe above functions are used to convert formatted output in the locale
67646bb83bSSascha Wildner.Fa loc .
68646bb83bSSascha WildnerThey behave in the same way as the versions without the _l suffix, but use
69646bb83bSSascha Wildnerthe specified locale rather than the global or per-thread locale.
70646bb83bSSascha WildnerSee the specific manual pages for more information.
71646bb83bSSascha Wildner.Sh SEE ALSO
72646bb83bSSascha Wildner.Xr wprintf 3 ,
73646bb83bSSascha Wildner.Xr xlocale 3
74646bb83bSSascha Wildner.Sh STANDARDS
75646bb83bSSascha WildnerThese functions do not conform to any specific standard so they should be
76646bb83bSSascha Wildnerconsidered as non-portable local extensions.
77