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