OS_VSNPrintfEx

Syntax

#include <nitro/os.h>

int OS_VSNPrintfEx( char *dst, size_t len, const char *fmt, va_list vlist );

Arguments

dst Storage destination buffer for the output string.
len Storage destination buffer size for the output string.
fmt Output format string.
vlist Variable argument list.

Return Values

Returns the number of characters with the format string output properly. The termination character ( \0 ) is not included in this number.

The output string is written to dst. If the output string is less than len, all of the strings and termination character ( \0 ) are written.
If the output string is greater than or equal to len AND
(1) len is not set to zero, the termination character ( \0 ) is written to dst[len - 1].
(2) If len is zero, nothing is done with dst.

Description

Returns the simplified version of the format string. This extends the features of the OS_VSNPrintf function and supports non-standard conversion specifiers. The currently supported conversion specifiers are as follows.

This function is compiled with weak symbols. Therefore, you can overwrite them with your own function definitions.

See Also

OS_VSNPrintf

Revision History

2006/10/23 Initial version.


CONFIDENTIAL