# STD_TVSScanf

## Syntax

  `#include <nitro/std.h>
  int STD_TVSScanf( const char *src, const char *fmt, va_list vlist );
  `

## Arguments

src | Input string.
fmt | Input format string.
vlist | List containing a variable number of arguments.

## Return Values

Returns the number of times format conversion was successful and the converted format was actually substituted.

When the end of src is reached without making even one successful format conversion, this function returns -1.

## Description

This function simplifies the format string.

This function operates identically to the `vsscanf` function with regard to the following features.

> - Integer conversion (`d, i, o, u, x, X, p`)
> - Characters or strings (`c, s`)
> - Getting scan positions (`n`)
> - Character classes (`[]`)

This function is compiled with weak symbols. Therefore, you can overwrite them with your own function definitions.
However, this function may be used by TWL-SDK functions, high-level libraries, middleware, and other sources, so be careful not to change its behavior when you overwrite it.

## See Also

`STD_TSScanf`
`OS_VSNPrintf`

## Revision History

2009/03/27 Added notes related to weak symbols and user-defined functions.
2006/11/16 Added character classes to the supported format.
2005/10/25 Initial version.

CONFIDENTIAL