stdio/xprintf.3

   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