GME  13
Functions | Variables
snprintf implementations
String routines
Collaboration diagram for snprintf implementations:

Functions

 APR_DECLARE_NONSTD (int) apr_snprintf(char *buf
apr_size_t const char __attribute__ ((format(printf, 3, 4)))

Variables

apr_size_t len
apr_size_t const char * format

Detailed Description

Warning:
These are snprintf implementations based on apr_vformatter().

Note that various standards and implementations disagree on the return value of snprintf, and side-effects due to n in the formatting string. apr_snprintf (and apr_vsnprintf) behaves as follows:

Process the format string until the entire string is exhausted, or the buffer fills. If the buffer fills then stop processing immediately (so no further n arguments are processed), and return the buffer length. In all cases the buffer is NUL terminated. It will return the number of characters inserted into the buffer, not including the terminating NUL. As a special case, if len is 0, apr_snprintf will return the number of characters that would have been inserted if the buffer had been infinite (in this case, *buffer can be NULL)

In no event does apr_snprintf return a negative number.


Function Documentation

apr_size_t const char __attribute__ ( (format(printf, 3, 4))  )

snprintf routine based on apr_vformatter. This means it understands the same extensions.

Parameters:
bufThe buffer to write to
lenThe size of the buffer
formatThe format string
...The arguments to use to fill out the format string.

Variable Documentation

apr_size_t const char* format

Definition at line 273 of file apr_strings.h.

apr_size_t len

Definition at line 273 of file apr_strings.h.