
drink_alcohol()
***************


FUNKTION
========

   public varargs int drink_alcohol(int strength, int testonly, string mytext)


DEFINIERT IN
============

   /std/living/life.c


ARGUMENTE
=========

   strength: wird zur aktuellen Saettigung P_ALCOHOL dazu addiert
   testonly: Ist das Flag gesetzt, wird dem Spieler kein ALCOHOL zugefuehrt.
             Darf nur zum Testen der Heilstelle verwendet werden und muss
             im normalen Betrieb auf '0' stehen!
   mytext: Wer selber einen Text bei Misserfolg ausgeben lassen moechte,
           darf sich hier was nettes ausdenken.
           Achtung: Das unterdrueckt nicht die "Nuechtern"-Meldung, die bei
           negativem strength auftreten kann, wenn P_ALCOHOL wieder 0 ist.


BESCHREIBUNG
============

   Es wird geprueft, ob dem Spieler der angegebene Wert fuer 'strength'
   auf seine aktuelle P_ALCOHOL addiert werden kann oder nicht. Falls
   das moeglich ist und testonly = 0, wird P_ALCOHOL entsprechend
   aktualisiert.

   Sollen neben P_ALCOHOL noch weitere Props manipuliert werden - bspw. zur
   Heilung eines Lebewesens - bietet sich die Funktion consume() an.


RUECKGABEWERT
=============

   0 bei [potentiellem] Misserfolg (strength + P_ALCOHOL > P_MAX_ALCOHOL)
   1 bei [potentiellem] Erfolg
   * potentiell bezieht sich hier auf Nutzung mit 'testonly' != 0


BEMERKUNG
=========

   drink_alocohol() bitte anstatt eigener Manipulationen von P_ALCOHOL und
   P_MAX_ALCOHOL verwenden.

   Achtung: Immer erst VOR einer Heilung ausfuehren und bei Erfolg heilen.

   Bei Heilstellen sollte eine evtl. Heilung des Spielers mit der eigens
   dafuer eingerichteten Funktion check_and_update_timed_key realisiert
   werden.


BEISPIEL
========

   int heilstelle() {
     if(this_player()->drink_alcohol(10, 0,
                                     "Du prustest in den Schnaps. "
                                     "Der passt nicht mehr rein.\n")) {
       // Platz fuer 10 "Alkohol" war noch, diese sind jetzt bereits addiert
       // Nachricht an den Spieler:
       tell_object(this_player(),
                   break_string("Du trinkst den Schnaps aus.", 78));

       // Nachricht an andere Livings im Raum
       object ob = first_inventory(environment(this_player()));
       do {
         if(living(ob) && ob!=this_player())
           ob->ReceiveMsg(this_player()->Name()+" trinkt einen Schnaps aus.",
                          MT_LOOK|MT_LISTEN,
                          MA_DRINK);
         ob = next_inventory(ob);
       } while(ob);

       // Rassenabhaengige Heilung: Sofort oder in Schritten
       // Tragbare Heilungen sollten auch eher buffer_hp/_sp benutzen.
       if(this_player()->QueryProp(P_REAL_RACE)=="Schnapsdrossel")
         this_player()->heal_self(30);
       else {
         this_player()->buffer_hp(30,5);
         this_player()->buffer_sp(30,5);
       }
     }

     return 1;
    }


SIEHE AUCH
==========

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

9. August 2015 Gloinson