blob: b0104eec365b5d979c5b9b71d8cfbb47fd0cd6b9 [file] [log] [blame]
Zesstra953f9972017-02-18 15:37:36 +01001
2FindGroupN()
3************
4
5
6FUNKTION
7========
8
9 object*FindGroupN(object pl,int who,int n);
10
11
12DEFINIERT IN
13============
14
15 /std/spellbook.c
16
17
18ARGUMENTE
19=========
20
21 pl
22 Lebewesen, von welchem die Freunde oder Feinde in der Umgebung
23 gefunden werden sollen.
24 who
25 Flag, welches anzeigt, ob Freunde oder Feinde gefunden werden
26 sollen (Konstanten definiert in '/sys/new_skills.h'):
27 FG_ENEMIES - (Wert -1) Feinde sollen gefunden werden
28 FG_FRIENDS - (Wert 1) Freunde sollen gefunden werden
29 FG_ALL - (Wert 0) alle Lebewesen sollen gefunden werden
30 n
31 Anzahl der Lebewesen, die zurueckgegeben werden sollen.
32 Hierbei geht vorher noch das Skillattribute SA_EXTENSION ein!
33 Es wird mindestens 1 Lebewesen zurueckgeliefert (sofern gefunden).
34
35
36RUeCKGABEWERT
37=============
38
39 Array mit gefundenen Lebewesen
40
41
42BESCHREIBUNG
43============
44
45 Ausgesucht werden die Lebewesen genauso wie bei FindGroup(), nur
46 dass zum Schluss die Anzahl noch begrenzt wird.
47
48
49BEISPIELE
50=========
51
52 Man moechte maximal 5 Feinde finden, die man gleichzeitig mit einem
53 Spell belegen kann:
54 enemyList=FindGroupN(caster,FG_ENEMIES,5);
55 Dies gilt jedoch nur bei SA_EXTENSION==100, sonst wird
56 dementsprechend mehr oder weniger zurueckgegeben.
57 (also bei SA_EXTENSION==200 doppelt so viele -> 10 Lebewesen)
58 Das Skillattribute SA_EXTENSION kann auch durch SA_QUALITY
59 veraendert worden sein; das sollte beachtet werden.
60
61
62SIEHE AUCH
63==========
64
65 FindGroup(), FindGroupP(), P_FRIEND, P_NO_GLOBAL_ATTACK
66
67Last modified: Mon Jan 25 15:04:31 1999 by Patryn