EFUN: sscanf

SYNTAX:
int sscanf( str, fmt_str, var1, var2, ... );
  string str;
  string fmt_str;
  mixed var#;

DESCRIPTION:
Sscanf tries to match the string 'str' to the format string 'fmt_str'.
Any matches are stored in the specified variables 'var#'.
Next to plain text, the format string can contain any number of variable
type specifiers '%<variable type>'. The number and type of variables
'var#' must be the same as specified in the format string.

Valid variable type specifiers are:
"%s" for strings.
"%d" for integers.

RETURN VALUE:
Number of variables that could be matched is returned.

SEE ALSO:
sprintf
extract
explode

EXAMPLE:
string str;
string type1, type2;
int amount1, amount2;
int i;

str = "1 gold and 7 copper coins";
i = sscanf( str, "%d %s and %d %s coins", amount1, type1, amount2, type2 );
// i is now 4.
// amount1 is now 1, type1 is "gold", amount2 is 7, and type2 is "copper".
