STD_TVSNPrintf

Syntax

#include <nitro/std.h>

int STD_TVSNPrintf( 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 the strings and termination character ( \0 ) are written. If the output string is greater than or equal to len and 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

This function returns the simplified version of the format string.

This function operates identically to vsnprintf() from MSL, but the following features cannot be used:

CodeWarrior extension Pascal string (#s) MSL AltiVec extensions (v, vh, vl, hv, lv, @) Floating Points (e, E, f, g, G, a, A) Wide string (wchar_t) NOTE: The shift_JIS mutlibyte string can be used.

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

See Also

STD_TSPrintf STD_TVSPrintf STD_TSNPrintf

Revision History

2007/04/20 Initial version.


CONFIDENTIAL