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.\" $FreeBSD$ 26af27459aSIsabell Long.\" 27af27459aSIsabell Long.Dd April 8, 2012 28af27459aSIsabell Long.Dt SCANF_L 3 29af27459aSIsabell Long.Os 30af27459aSIsabell Long.Sh NAME 31af27459aSIsabell Long.Nm scanf_l , 32af27459aSIsabell Long.Nm fscanf_l , 33af27459aSIsabell Long.Nm sscanf_l , 34af27459aSIsabell Long.Nm vfscanf_l , 35af27459aSIsabell Long.Nm vscanf_l , 36af27459aSIsabell Long.Nm vsscanf_l 37af27459aSIsabell Long.Nd input format conversion 38af27459aSIsabell Long.Sh LIBRARY 39af27459aSIsabell Long.Lb libc 40af27459aSIsabell Long.Sh SYNOPSIS 41af27459aSIsabell Long.In stdio.h 42af27459aSIsabell Long.Ft int 43af27459aSIsabell Long.Fn scanf_l "locale_t loc" "const char * restrict format" "..." 44af27459aSIsabell Long.Ft int 45af27459aSIsabell Long.Fn fscanf_l "FILE * restrict stream" "locale_t loc" "const char * restrict format" "..." 46af27459aSIsabell Long.Ft int 47af27459aSIsabell Long.Fn sscanf_l "const char * restrict str" "locale_t loc" "const char * restrict format" "..." 48af27459aSIsabell Long.Ft int 49af27459aSIsabell Long.Fn vfscanf_l "FILE * restrict stream" "locale_t loc" "const char * restrict format" "va_list ap" 50af27459aSIsabell Long.Ft int 51af27459aSIsabell Long.Fn vscanf_l "locale_t loc" "const char * restrict format" "va_list ap" 52af27459aSIsabell Long.Ft int 53af27459aSIsabell Long.Fn vsscanf_l "const char * restrict str" "locale_t loc" "const char * restrict format" "va_list ap" 54af27459aSIsabell Long.Sh DESCRIPTION 55af27459aSIsabell LongThe above functions scan input according to a specified 56af27459aSIsabell Long.Fa format 57af27459aSIsabell Longin the locale 58af27459aSIsabell Long.Fa loc . 59af27459aSIsabell LongThey behave in the same way as the versions without the _l suffix, but use 60*96240c89SEitan Adlerthe specific locale rather than the global or per-thread locale. 61af27459aSIsabell LongSee the specific manual pages for more information. 62af27459aSIsabell Long.Sh SEE ALSO 63af27459aSIsabell Long.Xr scanf 3 , 64af27459aSIsabell Long.Xr xlocale 3 65af27459aSIsabell Long.Sh STANDARDS 66af27459aSIsabell LongThese functions do not conform to any specific standard so they should be 67af27459aSIsabell Longconsidered as non-portable local extensions. 68af27459aSIsabell Long.Sh HISTORY 69af27459aSIsabell LongThese functions first appeared in Darwin and were first implemented in 70af27459aSIsabell Long.Fx 9.1 . 71