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