DragonFly On-Line Manual Pages

Search: Section:  

firestring_snprintf(3)                      DragonFly Library Functions Manual


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)

Search: Section: