xref: /freebsd/lib/libc/stdio/scanf_l.3 (revision af27459acec66f437641c948327c23db71aa5df0)
1*af27459aSIsabell Long.\" Copyright (c) 2012 Isabell Long <issyl0@FreeBSD.org>
2*af27459aSIsabell Long.\" All rights reserved.
3*af27459aSIsabell Long.\"
4*af27459aSIsabell Long.\" Redistribution and use in source and binary forms, with or without
5*af27459aSIsabell Long.\" modification, are permitted provided that the following conditions
6*af27459aSIsabell Long.\" are met:
7*af27459aSIsabell Long.\" 1. Redistributions of source code must retain the above copyright
8*af27459aSIsabell Long.\"    notice, this list of conditions and the following disclaimer.
9*af27459aSIsabell Long.\" 2. Redistributions in binary form must reproduce the above copyright
10*af27459aSIsabell Long.\"    notice, this list of conditions and the following disclaimer in the
11*af27459aSIsabell Long.\"    documentation and/or other materials provided with the distribution.
12*af27459aSIsabell Long.\"
13*af27459aSIsabell Long.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14*af27459aSIsabell Long.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15*af27459aSIsabell Long.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16*af27459aSIsabell Long.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17*af27459aSIsabell Long.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18*af27459aSIsabell Long.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19*af27459aSIsabell Long.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20*af27459aSIsabell Long.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21*af27459aSIsabell Long.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22*af27459aSIsabell Long.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23*af27459aSIsabell Long.\" SUCH DAMAGE.
24*af27459aSIsabell Long.\"
25*af27459aSIsabell Long.\" $FreeBSD$
26*af27459aSIsabell Long.\"
27*af27459aSIsabell Long.Dd April 8, 2012
28*af27459aSIsabell Long.Dt SCANF_L 3
29*af27459aSIsabell Long.Os
30*af27459aSIsabell Long.Sh NAME
31*af27459aSIsabell Long.Nm scanf_l ,
32*af27459aSIsabell Long.Nm fscanf_l ,
33*af27459aSIsabell Long.Nm sscanf_l ,
34*af27459aSIsabell Long.Nm vfscanf_l ,
35*af27459aSIsabell Long.Nm vscanf_l ,
36*af27459aSIsabell Long.Nm vsscanf_l
37*af27459aSIsabell Long.Nd input format conversion
38*af27459aSIsabell Long.Sh LIBRARY
39*af27459aSIsabell Long.Lb libc
40*af27459aSIsabell Long.Sh SYNOPSIS
41*af27459aSIsabell Long.In stdio.h
42*af27459aSIsabell Long.Ft int
43*af27459aSIsabell Long.Fn scanf_l "locale_t loc" "const char * restrict format" "..."
44*af27459aSIsabell Long.Ft int
45*af27459aSIsabell Long.Fn fscanf_l "FILE * restrict stream" "locale_t loc" "const char * restrict format" "..."
46*af27459aSIsabell Long.Ft int
47*af27459aSIsabell Long.Fn sscanf_l "const char * restrict str" "locale_t loc" "const char * restrict format" "..."
48*af27459aSIsabell Long.Ft int
49*af27459aSIsabell Long.Fn vfscanf_l "FILE * restrict stream" "locale_t loc" "const char * restrict format" "va_list ap"
50*af27459aSIsabell Long.Ft int
51*af27459aSIsabell Long.Fn vscanf_l "locale_t loc" "const char * restrict format" "va_list ap"
52*af27459aSIsabell Long.Ft int
53*af27459aSIsabell Long.Fn vsscanf_l "const char * restrict str" "locale_t loc" "const char * restrict format" "va_list ap"
54*af27459aSIsabell Long.Sh DESCRIPTION
55*af27459aSIsabell LongThe above functions scan input according to a specified
56*af27459aSIsabell Long.Fa format
57*af27459aSIsabell Longin the locale
58*af27459aSIsabell Long.Fa loc .
59*af27459aSIsabell LongThey behave in the same way as the versions without the _l suffix, but use
60*af27459aSIsabell Longthe specific locale rather than the the global or per-thread locale.
61*af27459aSIsabell LongSee the specific manual pages for more information.
62*af27459aSIsabell Long.Sh SEE ALSO
63*af27459aSIsabell Long.Xr scanf 3 ,
64*af27459aSIsabell Long.Xr xlocale 3
65*af27459aSIsabell Long.Sh STANDARDS
66*af27459aSIsabell LongThese functions do not conform to any specific standard so they should be
67*af27459aSIsabell Longconsidered as non-portable local extensions.
68*af27459aSIsabell Long.Sh HISTORY
69*af27459aSIsabell LongThese functions first appeared in Darwin and were first implemented in
70*af27459aSIsabell Long.Fx 9.1 .
71