H_HOOK_CONSUME
==============

HOOK
----

  H_HOOK_CONSUME

DEFINIERT IN
------------

  /sys/hook.h

GERUFEN VON
-----------

  /std/living/life.c

BESCHREIBUNG
------------

  Wird ausgeloest, wenn ein Lebewesen etwas per consume() konsumiert.

HOOK-DATEN
----------

  Es wird ein Array uebergeben:
  ({mapping cinfo, int testonly})
  Die Elemente des Arrays entsprechen den Argumenten von consume(), siehe
  dort fuer ausfuehrliche Dokumentation.

BEMERKUNGEN
-----------

  testonly kann durch den Hook nicht veraendert werden.

  Die in "man consume" erwaehnte alte Form des Mappings wird leider noch
  benutzt, Stand heute (16.02.2018) u.A. von /std/pub. Beruecksichtigt das
  in eurem Code.

RUECKGABEWERTE
--------------

  ({ <status>, <daten> })
  <status>  : H_NO_MOD, H_CANCELLED, H_ALTERED
  <daten>   : wie uebergebenes Datenarray

SIEHE AUCH
----------

  HRegisterToHook(), HUnregisterFromHook(), HookFlow(), consume()

Letzte Aenderung: 06.10.2018, Bugfix