# 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