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 7, 2012 26af27459aSIsabell Long.Dt PRINTF_L 3 27af27459aSIsabell Long.Os 28af27459aSIsabell Long.Sh NAME 29af27459aSIsabell Long.Nm printf_l , 30af27459aSIsabell Long.Nm asprintf_l , 31af27459aSIsabell Long.Nm fprintf_l , 32af27459aSIsabell Long.Nm snprintf_l , 33af27459aSIsabell Long.Nm sprintf_l , 34af27459aSIsabell Long.Nm vasprintf_l , 35af27459aSIsabell Long.Nm vfprintf_l , 36af27459aSIsabell Long.Nm vprintf_l , 37af27459aSIsabell Long.Nm vsnprintf_l , 38af27459aSIsabell Long.Nm vsprintf_l 39af27459aSIsabell Long.Nd formatted output conversion 40af27459aSIsabell Long.Sh LIBRARY 41af27459aSIsabell Long.Lb libc 42af27459aSIsabell Long.Sh SYNOPSIS 43af27459aSIsabell Long.In stdio.h 44*f3ba5fc7SEitan Adler.In xlocale.h 45af27459aSIsabell Long.Ft int 46af27459aSIsabell Long.Fn printf_l "locale_t loc" "const char * restrict format" "..." 47af27459aSIsabell Long.Ft int 48af27459aSIsabell Long.Fn asprintf_l "char **ret" "locale_t loc" "const char * format" "..." 49af27459aSIsabell Long.Ft int 50af27459aSIsabell Long.Fn fprintf_l "FILE * restrict stream" "locale_t loc" "const char * restrict format" "..." 51af27459aSIsabell Long.Ft int 52af27459aSIsabell Long.Fn snprintf_l "char * restrict str" "size_t size" "locale_t loc" "const char * restrict format" "..." 53af27459aSIsabell Long.Ft int 54af27459aSIsabell Long.Fn sprintf_l "char * restrict str" "locale_t loc" "const char * restrict format" "..." 55af27459aSIsabell Long.Ft int 56af27459aSIsabell Long.Fn vasprintf_l "char **ret" "locale_t loc" "const char *format" "va_list ap" 57af27459aSIsabell Long.Ft int 58af27459aSIsabell Long.Fn vfprintf_l "FILE * restrict stream" "locale_t loc" "const char * restrict format" "va_list ap" 59af27459aSIsabell Long.Ft int 60af27459aSIsabell Long.Fn vprintf_l "locale_t loc" "const char * restrict format" "va_list ap" 61af27459aSIsabell Long.Ft int 62af27459aSIsabell Long.Fn vsnprintf_l "char * restrict str" "size_t size" "locale_t loc" "const char * restrict format" "va_list ap" 63af27459aSIsabell Long.Ft int 64af27459aSIsabell Long.Fn vsprintf_l "char * restrict str" "locale_t loc" "const char * restrict format" "va_list ap" 65af27459aSIsabell Long.Sh DESCRIPTION 66af27459aSIsabell LongThe above functions are used to convert formatted output in the locale 67af27459aSIsabell Long.Fa loc . 68af27459aSIsabell LongThey behave in the same way as the versions without the _l suffix, but use 69af27459aSIsabell Longthe specified locale rather than the global or per-thread locale. 70af27459aSIsabell LongSee the specific manual pages for more information. 71af27459aSIsabell Long.Sh SEE ALSO 72af27459aSIsabell Long.Xr printf 3 , 73af27459aSIsabell Long.Xr xlocale 3 74af27459aSIsabell Long.Sh STANDARDS 75af27459aSIsabell LongThese functions do not conform to any specific standard so they should be 76af27459aSIsabell Longconsidered as non-portable local extensions. 77af27459aSIsabell Long.Sh HISTORY 78af27459aSIsabell LongThese functions first appeared in Darwin and were first implemented in 79af27459aSIsabell Long.Fx 9.1 . 80