projects / apple / libc.git / blame
| Commit | Line | Data |
|---|---|---|
| 6465356a A |
1 | .Dd Aug 19, 2012 |
| 2 | .Dt XPRINTF 3 | |
| 3 | .Os Darwin | |
| 4 | .Sh NAME | |
| 5 | .Nm asxprintf , dxprintf , fxprintf , sxprintf , xprintf , | |
| 6 | .Nm vasxprintf , vdxprintf , vfxprintf , vsxprintf , vxprintf | |
| 7 | .Nd extensible printf | |
| 8 | .Sh SYNOPSIS | |
| 9 | .In printf.h | |
| 10 | .Ft int | |
| 11 | .Fn asxprintf "char ** restrict ret" "printf_domain_t restrict domain" "locale_t restrict loc" "const char * restrict format" ... | |
| 12 | .Ft int | |
| 13 | .Fn dxprintf "int fd" "printf_domain_t restrict domain" "locale_t restrict loc" "const char * restrict format" ... | |
| 14 | .Ft int | |
| 15 | .Fn fxprintf "FILE * restrict stream" "printf_domain_t restrict domain" "locale_t restrict loc" "const char * restrict format" ... | |
| 16 | .Ft int | |
| 17 | .Fn sxprintf "char * restrict str" "size_t size" "printf_domain_t restrict domain" "locale_t restrict loc" "const char * restrict format" ... | |
| 18 | .Ft int | |
| 19 | .Fn xprintf "printf_domain_t restrict domain" "locale_t restrict loc" "const char * restrict format" ... | |
| 20 | .In stdarg.h | |
| 21 | .Ft int | |
| 22 | .Fn vasxprintf "char ** restrict ret" "printf_domain_t restrict domain" "locale_t restrict loc" "const char * restrict format" "va_list ap" | |
| 23 | .Ft int | |
| 24 | .Fn vdxprintf "int fd" "printf_domain_t restrict domain" "locale_t restrict loc" "const char * restrict format" "va_list ap" | |
| 25 | .Ft int | |
| 26 | .Fn vfxprintf "FILE * restrict stream" "printf_domain_t restrict domain" "locale_t restrict loc" "const char * restrict format" "va_list ap" | |
| 27 | .Ft int | |
| 28 | .Fn vsxprintf "char * restrict str" "size_t size" "printf_domain_t restrict domain" "locale_t restrict loc" "const char * restrict format" "va_list ap" | |
| 29 | .Ft int | |
| 30 | .Fn vxprintf "printf_domain_t restrict domain" "locale_t restrict loc" "const char * restrict format" "va_list ap" | |
| 31 | .Sh DESCRIPTION | |
| 32 | These extensible printf (see | |
| 33 | .Xr xprintf 5 ) | |
| 34 | variants behave like their normal printf counterparts | |
| 35 | (see | |
| 36 | .Xr printf 3 ) | |
| 37 | without | |
| 38 | .Sq Li x | |
| 39 | in the name (except | |
| 40 | .Fn sxprintf | |
| 41 | and | |
| 42 | .Fn vsxprintf | |
| 43 | behave like | |
| 44 | .Fn snprintf | |
| 45 | and | |
| 46 | .Fn vsnprintf , | |
| 47 | respectively). | |
| 48 | .Pp | |
| 49 | The | |
| 50 | .Va domain | |
| 51 | argument must be a pointer to a printf domain structure, as returned by one of | |
| 52 | the functions described in | |
| 53 | .Xr xprintf_domain 3 . | |
| 54 | The | |
| 55 | .Va loc | |
| 56 | argument should be an extended locale (see | |
| 57 | .Xr xlocale 3 ) | |
| 58 | or NULL, which means to use the current locale in effect (either the per-thread | |
| 59 | locale if set, or the global locale by default). | |
| 60 | .Sh SEE ALSO | |
| 61 | .Xr printf 3 , | |
| 62 | .Xr xlocale 3 , | |
| 63 | .Xr xprintf_domain 3 , | |
| 64 | .Xr xprintf 5 |