Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 1 | AddMoney() |
| 2 | ========== |
| 3 | |
| 4 | AddMoney(L) |
| 5 | ----------- |
Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 6 | |
| 7 | FUNKTION |
| 8 | -------- |
Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 9 | |
| 10 | public int AddMoney(int amount); |
| 11 | |
| 12 | DEFINIERT IN |
| 13 | ------------ |
Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 14 | |
| 15 | /std/container/moneyhandler.c |
| 16 | /std/living/moneyhandler.c |
| 17 | /std/player/moneyhandler.c |
| 18 | |
| 19 | ARGUMENTE |
| 20 | --------- |
Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 21 | |
| 22 | int amount |
| 23 | Die zufuehrende oder abziehende Geldmenge |
| 24 | |
| 25 | BESCHREIBUNG |
| 26 | ------------ |
Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 27 | |
| 28 | Dem Spieler wird die in <amount> festgelegte Geldmenge abgezogen oder |
| 29 | zugefuehrt. |
| 30 | |
| 31 | RUeCKGABEWERT |
| 32 | ------------- |
Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 33 | |
| 34 | Technisch gesehen wird Geld mit entsprechendem <amount> erzeugt |
| 35 | ("/items/money.c") und mittels "move" in den Spieler bewegt. Das Ergebnis |
| 36 | dieses "move"-Aufrufes wird hier uebergeben, z.B. 1 fuer OK. |
| 37 | Die moeglichen Fehler-Konstanten sind in /sys/moving.h definiert, siehe |
| 38 | auch Dokumentation zu "move". |
| 39 | |
| 40 | BEMERKUNGEN |
| 41 | ----------- |
Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 42 | |
| 43 | <amount> kann sowohl positiv als auch negativ sein. Welche Auswirkungen |
| 44 | beide Faelle haben, sollte klar sein. Doch sollte bei einem negativen |
| 45 | <amount> vorher mittels QueryMoney() abgefragt werden, ob der Spieler |
| 46 | auch ueber ausreichend Geld verfuegt. |
| 47 | Wird dem Spieler Geld abgezogen, ist darauf zu achten, dieses in der |
| 48 | Zentralbank einzuzahlen (s.a.:PayIn() ). |
| 49 | Verschafft man dem Spieler Geld aus dem Nichts, muss es vorher bei der |
| 50 | Zentralbank abgebucht (WithDraw()) werden. |
| 51 | |
| 52 | Achtung: Kann der Spieler die in <amount> angebene Geldmenge nicht |
| 53 | tragen, werden ihm keine Muenzen in sein Inventar bewegt. Die |
| 54 | Fehlermeldung erkennt man an dem Rueckgabewert ME_TOO_HEAVY. |
| 55 | |
| 56 | Im Gegensatz zu Spielern haben alle anderen Objekte (Raeume, NPC, etc.) |
| 57 | standardmaessig keinen Moneyhandler. In diesem Fall muss in Lebewesen |
| 58 | "/std/living/moneyhandler" |
| 59 | und in nicht-Lebewesen |
| 60 | "/std/container/moneyhandler" |
| 61 | geerbt werden. |
| 62 | |
| 63 | BEISPIELE |
| 64 | --------- |
Arathorn | ae6dbc9 | 2020-07-27 23:36:15 +0200 | [diff] [blame] | 65 | |
| 66 | .. code-block:: pike |
Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 67 | |
Arathorn | 41004de | 2020-10-18 22:03:28 +0200 | [diff] [blame] | 68 | #include <bank.h> |
Bugfix | 5494181 | 2020-04-29 12:52:24 +0200 | [diff] [blame] | 69 | |
Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 70 | // gib ihm Geld |
Arathorn | 41004de | 2020-10-18 22:03:28 +0200 | [diff] [blame] | 71 | int money = ZENTRALBANK->WithDraw(50); |
Bugfix | 5494181 | 2020-04-29 12:52:24 +0200 | [diff] [blame] | 72 | this_player()->AddMoney(money); |
Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 73 | |
| 74 | // nimm ihm Geld |
| 75 | if(this_player()->AddMoney(-50)==1) |
Bugfix | 5494181 | 2020-04-29 12:52:24 +0200 | [diff] [blame] | 76 | { |
| 77 | write("Der Ork beklaut dich!\n"); |
| 78 | ZENTRALBANK->PayIn(50); |
| 79 | } |
Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 80 | |
| 81 | SIEHE AUCH |
| 82 | ---------- |
Arathorn | 41004de | 2020-10-18 22:03:28 +0200 | [diff] [blame] | 83 | :: |
Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 84 | |
Arathorn | 41004de | 2020-10-18 22:03:28 +0200 | [diff] [blame] | 85 | Geldhandling: QueryMoney(L) |
| 86 | Zentralbank: PayIn(L), WithDraw(L) |
| 87 | Sonstiges: move(L), |
| 88 | /items/money.c |
| 89 | /sys/moving.h, /std/container/moneyhandler.c |
| 90 | /sys/money.h, /sys/bank.h |
Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 91 | |
| 92 | 18.02.2013, Zesstra |
| 93 | |