.DT
parse_money
$MUDNAME$ handler help
parse_money
Name
.SI 5
parse_money - matches and checks money from a player
.EI
Syntax
.SI 5
varargs mixed parse_money( string words, object player, string place )
.EI
Description
.SP 5 5
This function, defined on the money handler, takes a string, the variable
words, and attempts to match it with objects in the object player; if
nothing matches the string, the function returns NO_MATCH. It then looks
at each object matched to check if it is money; if no money is found, the
function returns NO_MONEY. The handler then looks at the money, checking
to see if it is legal tender, according to the variable place, returning
any that isn't legal tender to the player; if there is no money that is
legal tender, the function returns NO_LEGAL. Given that the function
finds some legal tender, it returns that money object. The definition
MONEY_HAND for the money handler and the other definitions used above may
all be found in /include/money.h.
.EP
Examples
.SI 5
#include <money.h>
[some code]
int place_bet( string words ) {
mixed money;
if ( !words )
return notify_fail( "Bet what?\n" );
money = (mixed)MONEY_HAND->parse_money( words, this_player(),
"Ankh-Morpork" );
if ( !objectp( money ) )
switch ( money ) {
case NO_MATCH :
return notify_fail( "You don't have \""+ words +"\".\n" );
case NO_MONEY :
return notify_fail( "Try betting some money.\n" );
default :
return notify_fail( "Try betting some local currency.\n" );
}
[some more code]
} /* place_bet() */
.EI
See also
.SI 5
-
.EI
