NAME ^

src/misc.c - Miscellaneous functions

DESCRIPTION ^

Miscellaneous functions, mainly the Parrot_sprintf family.

Uses a generalized formatting algorithm (src/spf_render.c) with a specialized vtable (src/spf_vtable.c) to handle argument extraction.

Functions ^

The naming convention used is:

Parrot_v?n?sprintf

A (nearly) drop-in replacement for v?n?sprintf.

Parrot_v?sprintf_c

Takes a C-string format, returns a Parrot string.

Parrot_v?sprintf_s

Takes a Parrot string format, returns a Parrot string.

So the _ means "returns Parrot string" and the other letter indicates the type for the format.

STRING *Parrot_vsprintf_s(Interp *interpreter, STRING *pat, va_list args)

Almost all the other sprintf variants in this file are implemented in terms of this function (see Parrot_psprintf() for the exception). It in turn calls Parrot_sprintf_format() (see src/spf_render.c).

STRING *Parrot_vsprintf_c(Interp *interpreter, const char *pat, va_list args)

C string version of Parrot_vsprintf_s().

void Parrot_vsnprintf(Interp *interpreter, char *targ, size_t len, const char *pat, va_list args)

Similar to Parrot_vsprintf() but with an option to specify the length (len) of the returned C string.

STRING *Parrot_sprintf_s(Interp *interpreter, STRING *pat, ...)

Calls Parrot_vsprintf_s() with the va_list obtained from ....

STRING *Parrot_sprintf_c(Interp *interpreter, const char *pat, ...)

C string version of Parrot_sprintf_s().

void Parrot_snprintf(Interp *interpreter, char *targ, size_t len, const char *pat, ...)

Similar to Parrot_sprintf() but with an option to specify the length (len) of the returned C string.

STRING *Parrot_psprintf(Interp *interpreter, STRING *pat, PMC *ary)

Calls Parrot_sprintf_format() with the insertion arguments in an Array PMC.

SEE ALSO ^

src/misc.h, src/spf_vtable.c, src/spf_render.c.

HISTORY ^

This was once a simple, vararg-based implementation that existed completely within this file. When the file grew to be nearly 1,000 lines long, I split it into three. --BD


parrot