GetPlayerByIndex

Kategorie: Spieler
Ab Engineversion: 1.0 OC

Beschreibung

Gibt die indizierte Spielernummer zurück. Die Funktion garantiert für Werte zwischen 0 und GetPlayerCount()-1, dass eine gültige Spielernummer zurückgegeben wird (denn durch eliminierte Spieler und Neubeitritte kann es vorkommen, dass "Löcher" unbelegter Spielernummern in der Liste entstehen!). Damit ist es einfacher, eine Schleife zu schreiben, die alle Spielernummern durchgeht.

Syntax

int GetPlayerByIndex(int index, int player_type);

Parameter

index:
Index in der Spielerliste
player_type:
[opt] Wenn angegeben, wird der indizierte Spieler des angegebenen Typs zurückgegeben. So lassen sich zum Beispiel nur alle menschlichen oder nur alle Scriptspieler durchgehen. Für eine Liste gültiger Werte, siehe GetPlayerType.

Beispiele

for(var i = 0; i < GetPlayerCount(); i++)
  Log("Moin, %s", GetPlayerName(GetPlayerByIndex(i)));
Begrüßt alle Spieler im Log.
for(var i = 0; i < GetPlayerCount(C4PT_User); i++)
  EliminatePlayer(GetPlayerByIndex(i, C4PT_User));
Eliminiert alle regulären Spieler, aber lässt Scriptspieler am Leben.
Siehe auch: GetPlayerByName, GetPlayerCount, GetPlayerName, GetPlayerType
Sven2, 2007-12