
FindGroupN()
************


FUNKTION
========

   object*FindGroupN(object pl,int who,int n);


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

   /std/spellbook.c


ARGUMENTE
=========

   pl
     Lebewesen, von welchem die Freunde oder Feinde in der Umgebung
     gefunden werden sollen.
   who
     Flag, welches anzeigt, ob Freunde oder Feinde gefunden werden
     sollen (Konstanten definiert in '/sys/new_skills.h'):
       FG_ENEMIES - (Wert -1) Feinde sollen gefunden werden
       FG_FRIENDS - (Wert  1) Freunde sollen gefunden werden
       FG_ALL     - (Wert  0) alle Lebewesen sollen gefunden werden
   n
     Anzahl der Lebewesen, die zurueckgegeben werden sollen.
     Hierbei geht vorher noch das Skillattribute SA_EXTENSION ein!
     Es wird mindestens 1 Lebewesen zurueckgeliefert (sofern gefunden).


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

   Array mit gefundenen Lebewesen


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

   Ausgesucht werden die Lebewesen genauso wie bei FindGroup(), nur
   dass zum Schluss die Anzahl noch begrenzt wird.


BEISPIELE
=========

   Man moechte maximal 5 Feinde finden, die man gleichzeitig mit einem
   Spell belegen kann:
     enemyList=FindGroupN(caster,FG_ENEMIES,5);
   Dies gilt jedoch nur bei SA_EXTENSION==100, sonst wird
   dementsprechend mehr oder weniger zurueckgegeben.
    (also bei SA_EXTENSION==200 doppelt so viele -> 10 Lebewesen)
   Das Skillattribute SA_EXTENSION kann auch durch SA_QUALITY
   veraendert worden sein; das sollte beachtet werden.


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

   FindGroup(), FindGroupP(), P_FRIEND, P_NO_GLOBAL_ATTACK

Last modified: Mon Jan 25 15:04:31 1999 by Patryn