doc/lfun/locate_objects

locate_objects()
****************


FUNKTION
========

   object *locate_objects(string desc, int info);


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

   /std/container/restrictions.c


ARGUMENTE
=========

   desc
        Die Umschreibung des gesuchten Objektes.

   info
        Ist ungleich 0, wenn diese Funktion von /std/living/put_and_get.c
        aus aufgerufen wurde.


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

   Diese Funktion erweitert die Funktionalitaet von present_objects()
   insofern, als dass es moeglich ist, auch noch Behaelter innerhalb des
   Behaelters zu durchsuchen. Das genaue Verhalten haengt von desc ab:

   Ist desc von der Form "<id>", so wird das Ergebnis von
   present_objects(desc) zurueckgegeben.

   Ist desc von der Form "<gesucht> in <id>", so wird in allen Objekten,
   die von present_objects("<id>") erfasst wurden,
   locate_objects("<desc>") aufgerufen. Zurueckgegeben werden alle auf
   diese Weise gefundenen Objekte.


RUeCKGABEWERT
=============

   Array von Objekten, die auf die oben geschilderte Art und Weise
   ermittelt wurden. Konnte kein Objekt ermittelt werden, wird ein leeres
   Array zurueckgegeben.


BEMERKUNGEN
===========

   Theoretisch sollte es moeglich sein, ueber desc rekursiv mehrere
   Behaelterebenen erfassen zu koennen (etwa mit "schwert in beutel in
   beutel in wargon"). In der aktuellen Implementierung klappt das jedoch
   nicht; nach dem ersten "in" ist Schluss!


BEISPIELE
=========

   Was steckt alles dem Beutel, den der Spieler bei sich traegt?

   object *obs;
   obs = this_player()->locate_objects("alles in beutel");

   Traegt der Spieler keinen Beutel bei sich oder ist dieser leer, so wird
   ein leeres Array zurueckgegeben.


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

   present_objects(), /std/container/restrictions.c

Last modified: Wed May 8 10:20:36 1996 by Wargon