NAME
firestring_snprintf - snprintf(3) provided as a replacement so programs
can maintain ANSI C compliance
SYNOPSIS
#include <firestring.h>
-lfirestring
long firestring_snprintf(char * out, const size_t size, const char *
const format, ...)
DESCRIPTION
firestring_snprintf() writes a maximum of size bytes to out based on
the formatting rules specified in format and the further arguments
provided.
As snprintf(3) is not a ANSI C function, firestring_snprintf() is
provided as a replacement for programs wishing to maintain ANSI C
compliance. It acts much like snprintf(3), except that it only uses
single-letter format tags, and only supports a subset of the common
formats.
Formats supported:
%s - char *
%d - int
%l - long
%u - unsigned int
%y - unsigned long
%g - signed long long
%o - unsigned long long
%f - double
%t - time_t (printed in ISO format)
%e - struct firestring_estr_t *
The %s type handles NULL values by displaying the string "(null)". All
numeric types support zero padding through the standard %02d format.
RETURN VALUE
Returns the number of bytes written to out not including the trailing
nil.
AUTHOR
Ian Gulliver <ian@penguinhosting.net>
SEE ALSO
libfirestring(3)
2003-05-15 firestring_snprintf(3)