defuel_food()
=============

FUNKTION
--------
::

    int defuel_food();

DEFINIERT IN
------------
::

    /std/living/life.c

ARGUMENTE
---------
::

    Keine.

BESCHREIBUNG
------------
::

    Enttankt den Spieler automatisch um einen gewissen Essens-Wert,
    sofern der Spieler ueber einer bestimmten Enttank-Grenze liegt und seit
    seinem letzten Enttanken eine gewisse Zeit vergangen ist.
    Alle diese Werte sind rassenabhaengig.

    Es ist also NICHT moeglich, Einfluss auf die Menge des Enttankens
    zu nehmen. Das ist hier so gewollt.

    Hat der Spieler mindestens 
    * P_DEFUEL_LIMIT_FOOD in P_FOOD
    kann er alle
    * P_DEFUEL_TIME_FOOD
    um
    * (x=P_DRINK*P_DEFUEL_AMOUNT_FOOD/2) + random(x)
      (also um (50 bis 100 * P_FOOD) Prozent)
    enttanken.

RUECKGABEWERTE
--------------
::

    DEFUEL_TOO_SOON: -2, wenn Enttankintervallzeiten zu kurz.
    DEFUEL_TOO_LOW:  -1, wenn Enttankgrenze noch nicht erreicht.
    NO_DEFUEL:        0, wenn Enttanken nicht noetig war (Spieler war leer)
    >0, wenn Erfolg (enttankte Wert wird zurueckgegeben).

    (Konstanten kommen aus /sys/defuel.h)

BEMERKUNG
---------
::

    Bitte defuel_food() benutzen und nicht P_FOOD oder P_MAX_FOOD des
    Spielers manipulieren!

    Achtung: Nur Toiletten sollten diese Funktion im Spieler aufrufen!

BEISPIEL
--------
::

    int action_enttanken() {
      string msg;
      int val = this_player()->defuel_food();

      switch (val) {
        case DEFUEL_TOO_SOON:
          msg = "Du warst doch erst vor kurzem auf Toilette...";
          break;
        case DEFUEL_TOO_LOW:
          msg = "Du versuchst Dich zu entleeren, aber irgendwie will "
                "das nicht so recht klappen.";
          break;
        case NO_DEFUEL:
          msg = "Du hast seit langem nichts gegessen, wie willst Du dann "
                "was loswerden koennen?";
          break;
        default:
          string qualifier;
          int fuzzypercent = (90+random(20)) *
                             val/this_player()->QueryProp(P_MAX_FOOD);
          switch(fuzzypercent) {
            case 0..50:  qualifier = "etwas"; break;
            case 51..75: qualifier = "enorm"; break;
            default:     qualifier = "unglaublich"; break;
          }
          msg = "Du entleerst Dich "+qualifier"+. Puh, das tat gut!";
          break;
      }
      tell_object(this_player(), break_string(msg, 78));
      return 1;
    }

SIEHE AUCH
----------
::

     Aehnlich:  defuel_drink
     Tanken:    consume, drink_alcohol, drink_soft, eat_food
     Heilung:   heal_self, restore_spell_points, restore_hit_points, 
                buffer_hp, buffer_sp
     Timing:    check_and_update_timed_key
     Props:     P_DRINK, P_FOOD, P_ALCOHOL, P_SP, P_HP,
                P_DEFUEL_TIME_FOOD, P_DEFUEL_TIME_DRINK
     Konzepte:  heilung, enttanken, food

9. August 2015 Gloinson