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