[apple/libc.git] / stdio / xprintf_exec.3

.Dd Aug 19, 2012
.Dt XPRINTF_EXEC 3
.Os Darwin
.Sh NAME
.Nm asxprintf_exec , dxprintf_exec , fxprintf_exec , sxprintf_exec ,
.Nm xprintf_exec , vasxprintf_exec , vdxprintf_exec , vfxprintf_exec ,
.Nm vsxprintf_exec , vxprintf_exec
.Nd execute-only extensible printf execution
.Sh SYNOPSIS
.In printf.h
.Ft int
.Fn asxprintf_exec "char ** restrict ret" "printf_comp_t restrict pc" ...
.Ft int
.Fn dxprintf_exec "int fd" "printf_comp_t restrict pc" ...
.Ft int
.Fn fxprintf_exec "FILE * restrict stream" "printf_comp_t restrict pc" ...
.Ft int
.Fn sxprintf_exec "char * restrict str" "size_t size" "printf_comp_t restrict pc" ...
.Ft int
.Fn xprintf_exec "printf_comp_t restrict pc" ...
.In stdarg.h
.Ft int
.Fn vasxprintf_exec "char ** restrict ret" "printf_comp_t restrict pc" "va_list ap"
.Ft int
.Fn vdxprintf_exec "int fd" "printf_comp_t restrict pc" "va_list ap"
.Ft int
.Fn vfxprintf_exec "FILE * restrict stream" "printf_comp_t restrict pc" "va_list ap"
.Ft int
.Fn vsxprintf_exec "char * restrict str" "size_t size" "printf_comp_t restrict pc" "va_list ap"
.Ft int
.Fn vxprintf_exec "printf_comp_t restrict pc" "va_list ap"
.Sh DESCRIPTION
These functions are execute-only, extensible printf (see
.Xr xprintf 5 )
variants, taking a
.Ft printf_comp_t
structure created by the format string compilation routine
.Xr new_printf_comp 3 .
All these variants behave like their normal printf counterparts (see
.Xr printf 3 )
without
.Sq Li x
and
.Dq Li _exec
in the name (except
.Fn sxprintf_exec
and
.Fn vsxprintf_exec
behave like
.Fn snprintf
and
.Fn vsnprintf ,
respectively).
.Sh SEE ALSO
.Xr printf 3 ,
.Xr xprintf_comp 3 ,
.Xr xprintf 5
Commit	Line	Data
6465356a A	1	.Dd Aug 19, 2012
	2	.Dt XPRINTF_EXEC 3
	3	.Os Darwin
	4	.Sh NAME
	5	.Nm asxprintf_exec , dxprintf_exec , fxprintf_exec , sxprintf_exec ,
	6	.Nm xprintf_exec , vasxprintf_exec , vdxprintf_exec , vfxprintf_exec ,
	7	.Nm vsxprintf_exec , vxprintf_exec
	8	.Nd execute-only extensible printf execution
	9	.Sh SYNOPSIS
	10	.In printf.h
	11	.Ft int
	12	.Fn asxprintf_exec "char ** restrict ret" "printf_comp_t restrict pc" ...
	13	.Ft int
	14	.Fn dxprintf_exec "int fd" "printf_comp_t restrict pc" ...
	15	.Ft int
	16	.Fn fxprintf_exec "FILE * restrict stream" "printf_comp_t restrict pc" ...
	17	.Ft int
	18	.Fn sxprintf_exec "char * restrict str" "size_t size" "printf_comp_t restrict pc" ...
	19	.Ft int
	20	.Fn xprintf_exec "printf_comp_t restrict pc" ...
	21	.In stdarg.h
	22	.Ft int
	23	.Fn vasxprintf_exec "char ** restrict ret" "printf_comp_t restrict pc" "va_list ap"
	24	.Ft int
	25	.Fn vdxprintf_exec "int fd" "printf_comp_t restrict pc" "va_list ap"
	26	.Ft int
	27	.Fn vfxprintf_exec "FILE * restrict stream" "printf_comp_t restrict pc" "va_list ap"
	28	.Ft int
	29	.Fn vsxprintf_exec "char * restrict str" "size_t size" "printf_comp_t restrict pc" "va_list ap"
	30	.Ft int
	31	.Fn vxprintf_exec "printf_comp_t restrict pc" "va_list ap"
	32	.Sh DESCRIPTION
	33	These functions are execute-only, extensible printf (see
	34	.Xr xprintf 5 )
	35	variants, taking a
	36	.Ft printf_comp_t
	37	structure created by the format string compilation routine
	38	.Xr new_printf_comp 3 .
	39	All these variants behave like their normal printf counterparts (see
	40	.Xr printf 3 )
	41	without
	42	.Sq Li x
	43	and
	44	.Dq Li _exec
	45	in the name (except
	46	.Fn sxprintf_exec
	47	and
	48	.Fn vsxprintf_exec
	49	behave like
	50	.Fn snprintf
	51	and
	52	.Fn vsnprintf ,
	53	respectively).
	54	.Sh SEE ALSO
	55	.Xr printf 3 ,
	56	.Xr xprintf_comp 3 ,
	57	.Xr xprintf 5