Lpc Manpages

FUNKTION:
    public varargs int AddMoney( int amount, string currency )

DEFINIERT IN:
    /std/player/moneyhandler.c

ARGUMENTE:
    int amount - Die zuzufuehrende oder abzuziehende Geldmenge.

    string currency - Die entsprechende Waehrung.

BESCHREIBUNG:
    Dem Spieler wird die in 'amount' festgelegte Geldmenge abgezogen oder
    zugefuehrt. Dies kann in verschiedenen Waehrungen erfolgen.
    Falls 'currency' nicht angegeben wird, werden standardmaessig
    GOLDMUENZEN angenommen.

RUECKGABEWERT:
    Technisch gesehen wird Geld mit entsprechendem 'amount' erzeugt
    ("/obj/currency/*.c") und mittels "move" in den Spieler bewegt.
    Das Ergebnis dieses Aufrufs wird hier uebergeben, z.B. 1 fuer Ok.
    Die moeglichen Fehler-Konstanten sind in /sys/moving.h definiert.

BEMERKUNGEN:
    'amount' kann sowohl positiv als auch negativ sein. Welche Auswirkungen
    beide Faelle haben, sollte klar sein. Doch sollte bei einem negativen
    'amount' vorher mittels QueryMoney() abgefragt werden, ob der Spieler
    auch ueber ausreichend Geld verfuegt!
    Wird dem Spieler Geld abgezogen, ist darauf zu achten, dieses in der
    Zentralbank einzuzahlen (s. "man PayIn").
    Verschafft man dem Spieler Geld aus dem Nichts, muss es vorher bei der
    Zentralbank abgebucht werden (s. "man WithDraw").

    ACHTUNG: Kann der Spieler die in 'amount' angebene Geldmenge nicht mehr
    tragen, werden ihm keine Muenzen in sein Inventar bewegt. Die
    Fehlermeldung erkennt man an dem Rueckgabewert ME_TOO_HEAVY.

BEISPIELE:

    #include <bank.h>
    ...

    1. einem Spieler 500 Dinare verschaffen:

       if ( TP->AddMoney(500,DINARE) == MOVE_OK )
        write("Du findest 500 Dinare auf dem Boden! Schnell steckst Du sie "
              "ein.\n");


    2. einem Spieler alle Goldmuenzen klauen

       int geld = TP->QueryMoney(GOLDMUENZEN);

       if ( geld )
        {
         TP->AddMoney(-geld,GOLDMUENZEN);

         write("Der Ork klaut Dir all Deine Goldmuenzen!\n");
        }


SIEHE AUCH:
    Geld:    QueryMoney
    Bank:    CheckCurrency, ChangeCurrency, PayIn, WithDraw

----------------------------------------------------------------------------
01.11.17, Torin