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 42*f3ba5fc7SEitan Adler.In xlocale.h 43af27459aSIsabell Long.Ft int 44af27459aSIsabell Long.Fn scanf_l "locale_t loc" "const char * restrict format" "..." 45af27459aSIsabell Long.Ft int 46af27459aSIsabell Long.Fn fscanf_l "FILE * restrict stream" "locale_t loc" "const char * restrict format" "..." 47af27459aSIsabell Long.Ft int 48af27459aSIsabell Long.Fn sscanf_l "const char * restrict str" "locale_t loc" "const char * restrict format" "..." 49af27459aSIsabell Long.Ft int 50af27459aSIsabell Long.Fn vfscanf_l "FILE * restrict stream" "locale_t loc" "const char * restrict format" "va_list ap" 51af27459aSIsabell Long.Ft int 52af27459aSIsabell Long.Fn vscanf_l "locale_t loc" "const char * restrict format" "va_list ap" 53af27459aSIsabell Long.Ft int 54af27459aSIsabell Long.Fn vsscanf_l "const char * restrict str" "locale_t loc" "const char * restrict format" "va_list ap" 55af27459aSIsabell Long.Sh DESCRIPTION 56af27459aSIsabell LongThe above functions scan input according to a specified 57af27459aSIsabell Long.Fa format 58af27459aSIsabell Longin the locale 59af27459aSIsabell Long.Fa loc . 60af27459aSIsabell LongThey behave in the same way as the versions without the _l suffix, but use 6196240c89SEitan Adlerthe specific locale rather than the global or per-thread locale. 62af27459aSIsabell LongSee the specific manual pages for more information. 63af27459aSIsabell Long.Sh SEE ALSO 64af27459aSIsabell Long.Xr scanf 3 , 65af27459aSIsabell Long.Xr xlocale 3 66af27459aSIsabell Long.Sh STANDARDS 67af27459aSIsabell LongThese functions do not conform to any specific standard so they should be 68af27459aSIsabell Longconsidered as non-portable local extensions. 69af27459aSIsabell Long.Sh HISTORY 70af27459aSIsabell LongThese functions first appeared in Darwin and were first implemented in 71af27459aSIsabell Long.Fx 9.1 . 72