xref: /dflybsd-src/lib/libc/stdio/wprintf_l.3 (revision 646bb83b349cbfdffa1b0792cce1fb34ca25bf87)
1*646bb83bSSascha Wildner.\" Copyright (c) 1990, 1991, 1993
2*646bb83bSSascha Wildner.\"	The Regents of the University of California.  All rights reserved.
3*646bb83bSSascha Wildner.\"
4*646bb83bSSascha Wildner.\" This code is derived from software contributed to Berkeley by
5*646bb83bSSascha Wildner.\" Chris Torek and the American National Standards Committee X3,
6*646bb83bSSascha Wildner.\" on Information Processing Systems.
7*646bb83bSSascha Wildner.\"
8*646bb83bSSascha Wildner.\" Redistribution and use in source and binary forms, with or without
9*646bb83bSSascha Wildner.\" modification, are permitted provided that the following conditions
10*646bb83bSSascha Wildner.\" are met:
11*646bb83bSSascha Wildner.\" 1. Redistributions of source code must retain the above copyright
12*646bb83bSSascha Wildner.\"    notice, this list of conditions and the following disclaimer.
13*646bb83bSSascha Wildner.\" 2. Redistributions in binary form must reproduce the above copyright
14*646bb83bSSascha Wildner.\"    notice, this list of conditions and the following disclaimer in the
15*646bb83bSSascha Wildner.\"    documentation and/or other materials provided with the distribution.
16*646bb83bSSascha Wildner.\" 3. Neither the name of the University nor the names of its contributors
17*646bb83bSSascha Wildner.\"    may be used to endorse or promote products derived from this software
18*646bb83bSSascha Wildner.\"    without specific prior written permission.
19*646bb83bSSascha Wildner.\"
20*646bb83bSSascha Wildner.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21*646bb83bSSascha Wildner.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22*646bb83bSSascha Wildner.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23*646bb83bSSascha Wildner.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24*646bb83bSSascha Wildner.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25*646bb83bSSascha Wildner.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26*646bb83bSSascha Wildner.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27*646bb83bSSascha Wildner.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28*646bb83bSSascha Wildner.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29*646bb83bSSascha Wildner.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30*646bb83bSSascha Wildner.\" SUCH DAMAGE.
31*646bb83bSSascha Wildner.\"
32*646bb83bSSascha Wildner.\"     @(#)printf.3	8.1 (Berkeley) 6/4/93
33*646bb83bSSascha Wildner.\" $FreeBSD: head/lib/libc/stdio/wprintf.3 208027 2010-05-13 12:07:55Z uqs $
34*646bb83bSSascha Wildner.\"
35*646bb83bSSascha Wildner.Dd November 17, 2013
36*646bb83bSSascha Wildner.Dt WPRINTF 3
37*646bb83bSSascha Wildner.Os
38*646bb83bSSascha Wildner.Sh NAME
39*646bb83bSSascha Wildner.Nm wprintf_l ,
40*646bb83bSSascha Wildner.Nm fwprintf_l ,
41*646bb83bSSascha Wildner.Nm swprintf_l ,
42*646bb83bSSascha Wildner.Nm vfwprintf_l ,
43*646bb83bSSascha Wildner.Nm vswprintf_l ,
44*646bb83bSSascha Wildner.Nm vwprintf_l
45*646bb83bSSascha Wildner.Nd formatted wide character output conversion
46*646bb83bSSascha Wildner.Sh LIBRARY
47*646bb83bSSascha Wildner.Lb libc
48*646bb83bSSascha Wildner.Sh SYNOPSIS
49*646bb83bSSascha Wildner.In stdio.h
50*646bb83bSSascha Wildner.In wchar.h
51*646bb83bSSascha Wildner.In xlocale.h
52*646bb83bSSascha Wildner.Ft int
53*646bb83bSSascha Wildner.Fn fwprintf_l "FILE * restrict stream" "locale_t loc" "const wchar_t * restrict format" ...
54*646bb83bSSascha Wildner.Ft int
55*646bb83bSSascha Wildner.Fn swprintf_l "wchar_t * restrict ws" "size_t n" "locale_t loc" "const wchar_t * restrict format" ...
56*646bb83bSSascha Wildner.Ft int
57*646bb83bSSascha Wildner.Fn wprintf_l "locale_t loc" "const wchar_t * restrict format" ...
58*646bb83bSSascha Wildner.In stdarg.h
59*646bb83bSSascha Wildner.Ft int
60*646bb83bSSascha Wildner.Fn vfwprintf_l "FILE * restrict stream" "locale_t loc" "const wchar_t * restrict format" "va_list ap"
61*646bb83bSSascha Wildner.Ft int
62*646bb83bSSascha Wildner.Fn vswprintf_l "wchar_t * restrict ws" "size_t n" "locale_t loc" "const wchar_t *restrict format" "va_list ap"
63*646bb83bSSascha Wildner.Ft int
64*646bb83bSSascha Wildner.Fn vwprintf_l "locale_t loc" "const wchar_t * restrict format" "va_list ap"
65*646bb83bSSascha Wildner.Sh DESCRIPTION
66*646bb83bSSascha WildnerThe above functions are used to convert formatted output in the locale
67*646bb83bSSascha Wildner.Fa loc .
68*646bb83bSSascha WildnerThey behave in the same way as the versions without the _l suffix, but use
69*646bb83bSSascha Wildnerthe specified locale rather than the global or per-thread locale.
70*646bb83bSSascha WildnerSee the specific manual pages for more information.
71*646bb83bSSascha Wildner.Sh SEE ALSO
72*646bb83bSSascha Wildner.Xr wprintf 3 ,
73*646bb83bSSascha Wildner.Xr xlocale 3
74*646bb83bSSascha Wildner.Sh STANDARDS
75*646bb83bSSascha WildnerThese functions do not conform to any specific standard so they should be
76*646bb83bSSascha Wildnerconsidered as non-portable local extensions.
77