firestring_snprintf(3) [debian man page]

firestring_snprintf(3)					     Library Functions Manual					    firestring_snprintf(3)

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 compli-
       ance.  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 for-
       mat.

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)

explain_snprintf_or_die(3)				     Library Functions Manual					explain_snprintf_or_die(3)

NAME

       explain_snprintf_or_die - formatted output conversion and report errors

SYNOPSIS

       #include <libexplain/snprintf.h>
       int explain_snprintf_or_die(char *data, size_t data_size, const char *format);
       int explain_snprintf_on_error(char *data, size_t data_size, const char *format);

DESCRIPTION

       The  explain_snprintf_or_die  function  is  used  to call the snprintf(3) system call. On failure an explanation will be printed to stderr,
       obtained from the explain_snprintf(3) function, and then the process terminates by calling exit(EXIT_FAILURE).

       The explain_snprintf_on_error function is used to call the snprintf(3) system call. On failure an explanation will be  printed  to  stderr,
       obtained from the explain_snprintf(3) function, but still returns to the caller.

       data    The data, exactly as to be passed to the snprintf(3) system call.

       data_size
	       The data_size, exactly as to be passed to the snprintf(3) system call.

       format  The format, exactly as to be passed to the snprintf(3) system call.

RETURN VALUE

       The  explain_snprintf_or_die  function only returns on success, see snprintf(3) for more information. On failure, prints an explanation and
       exits, it does not return.

       The explain_snprintf_on_error function always returns the value return by the wrapped snprintf(3) system call.

EXAMPLE

       The explain_snprintf_or_die function is intended to be used in a fashion similar to the following example:
	      int result = explain_snprintf_or_die(data, data_size, format);

SEE ALSO

       snprintf(3)
	       formatted output conversion

       explain_snprintf(3)
	       explain snprintf(3) errors

       exit(2) terminate the calling process

COPYRIGHT

       libexplain version 0.52
       Copyright (C) 2010 Peter Miller

															explain_snprintf_or_die(3)