Arrays - Versionsgeschichte

Boronenherrscher am 19. August 2011 um 23:15 Uhr

2011-08-19T23:15:25Z

← Nächstältere Version		Version vom 20. August 2011, 01:15 Uhr
Zeile 1:		Zeile 1:
	{{HinweisBox\|Diese Seite ist in Bearbeitung durch [[Benutzer:4th Fleet Commander\|4th Fleet Commander]]. Solange dieses Banner hier steht, werden sämtliche Änderungen ohne Vorwarnung überschrieben.}}		{{HinweisBox\|Diese Seite ist in Bearbeitung durch [[Benutzer:4th Fleet Commander\|4th Fleet Commander]]. Solange dieses Banner hier steht, werden sämtliche Änderungen ohne Vorwarnung überschrieben.}}

	{{TutorialBar2\|[[Selbstausführende Scripts]]\| "[[X3:Terran Conflict Scripting-Tutorial]]"\|[[Objekte erstellen]]}}		{{TutorialBar2\|[[Selbstausführende Scripts]]\| "[[X3:Terran Conflict Scripting-Tutorial\|X³: Terran Conflict Scripting-Tutorial]]"\|[[Objekte erstellen]]}}

	Nun soll es um Arrays gehen. Die Arrays braucht man relativ häufig beim Scripten in X³: TC, da sie eine wichtige Variablenform darstellen.<br>		Nun soll es um Arrays gehen. Die Arrays braucht man relativ häufig beim Scripten in X³: TC, da sie eine wichtige Variablenform darstellen.<br>

Boronenherrscher am 19. August 2011 um 23:10 Uhr

2011-08-19T23:10:45Z

4th Fleet Commander: ergänzt

2011-05-31T10:23:29Z

ergänzt

@@ Zeile 3: / Zeile 3: @@
 {{TutorialBar2|[[Selbstausführende Scripts]]| "[[X3:Terran Conflict Scripting-Tutorial]]"|[[Objekte erstellen]]}}
-Nun soll es um Arrays gehen. Die Arrays braucht man relativ häufig beim Scripten in X3TC, da sie eine wichtige Variablenform darstellen.
+Nun soll es um Arrays gehen. Die Arrays braucht man relativ häufig beim Scripten in X3TC, da sie eine wichtige Variablenform darstellen. <br>
 ==Was ist ein Array?==
@@ Zeile 71: / Zeile 72: @@
 Jetzt wurden alle Werte im Array ausgelesen.

4th Fleet Commander: erstellt

2011-05-30T21:15:44Z

erstellt

Neue Seite

{{HinweisBox|Diese Seite ist in Bearbeitung durch [[Benutzer:4th Fleet Commander|4th Fleet Commander]]. Solange dieses Banner hier steht, werden sämtliche Änderungen ohne Vorwarnung überschrieben.}}

{{TutorialBar2|[[Selbstausführende Scripts]]| "[[X3:Terran Conflict Scripting-Tutorial]]"|[[Objekte erstellen]]}}

Nun soll es um Arrays gehen. Die Arrays braucht man relativ häufig beim Scripten in X3TC, da sie eine wichtige Variablenform darstellen.

==Was ist ein Array?==
Ein Array ist erst einmal nur eine Variable, jedoch eine ganz besondere. Eine normale Variable kann nur einen Wert aufnehmen, z.B. eine Zahl, einen Namen, eine Schiffsklasse einen Sektor etc. 
Ein Array kann jedoch mehrere Werte in sich aufnehmen. Hierzu nutzt es sogenannte Indizes, an denen die einzelnen Werte gespeichert werden. Die einzelnen Werte können auch verschieden sein, man kann also durchaus Zahlen zusammen mit Schiffen in ein Array packen. Man kann auch mehrere Arrays ineinander packen, dies macht vor allem bei Flottenverbänden für die KI einen Sinn.

==Wie ist ein Array aufgebaut?==
Wir schauen uns zunächst einmal den Grundcode eines Arrays an. Der sieht folgendermaßen aus:
{{ScriptCode|<nowiki>ARRAY (Buster, 1, 'Hallo', Erzgürtel, Energiezellen, {{Bewegliches Schiff}} )</nowiki>}}
So sieht ein Array aus. Nun wollen wir uns das ganze mal detaillierter anschauen:

An erster Stelle steht das Wort ARRAY. Dieses dient im Grunde nur dazu, damit man weiß, dass es sich um ein Array handelt. In den Klammern stehen nun die im Array enthaltenen Werte. 
Die einzelnen Werte sind durch Kommata voneinander getrennt. Die Kommata markieren die einzelnen Indizes. '''Wichtig:''' Der erste Index (hier ist dort "Buster" gespeichert) hat die Nummer 0, und nicht die 1.

==Wie lese ich ein Array aus?==

Die Werte aus dem Array kann man nun per Code abfragen. Dazu verwendet man den Namen des Arrays, gefolgt von der Nummer des Index, die in eckigen Klammern geschrieben wird. Wir nennen unser Array nun einmal "Testarray", und fragen nun die Werte ab. 
Wir möchten nun den Wert "Energiezellen" aus dem Array auslesen. Dieser steht an fünfter Stelle im Array, doch da der erste Index die Nummer 0 hat, stehen die Energiezellen an Index Nummer 4.

Der Befehl sieht nun folgendermaßen aus:
{{ScriptCode|<nowiki>$Ergebnis = $Testarray[4]</nowiki>}}
Die Variable "$Ergebnis" würde hier nun den Wert "Energiezellen" annehmen.

Wenn man jetzt aber das Array nicht selbst erstellt hat, oder man aus sonstigen Gründen nicht weiß, wie viele Indizes das Array hat, so kann man das abfragen. Das macht man mit dem Befehl:
{{ScriptCode|<nowiki>$Ergebnis = size of array $Testarray</nowiki>}}
Dieser Befehl liefert nun die Größe des Arrays, sprich also, wie viele Indizes darin enthalten sind. '''Wichtig:''' Dieser Wert entspricht nicht der Nummer des letzten Index', da der erste Index ja wieder die Nummer 0 hat. So muss hier 1 abgezogen werden, um die Nummer des letzten Index zu ermitteln.

===Systematisches Auslesen===
Man kann so ein Array jetzt auch systematisch auslesen. Dies macht man mit der "while-Schleife", die schon vorher erklärt wurde.

'''Vorgehensweise:''' 
Das Script soll nun folgendes machen:
*Größe des Arrays ermitteln
*Eine Zähler-Variable auf diese Größe setzen
*Die while-Schleife beginnen
*Die Zählervariable um 1 senken
*Den Wert des Arrays am Index der Zählervariable auslesen
*Mit diesem Wert arbeiten
*Die Schleife beenden

Und so sieht der zugehörige Code aus:
{{ScriptCode|<nowiki>$zaehler = size of array $Testarray</nowiki> 
<nowiki>while $zaehler > 0</nowiki> 
<nowiki>dec $zaehler=</nowiki> 
<nowiki>$array.wert = $Testarray[$zaehler]</nowiki> 
''<nowiki>*Hier kommt jetzt das hin, was ihr mit dem Wert machen wollt</nowiki>'' 
<nowiki>=wait 10ms</nowiki> 
<nowiki>end</nowiki>}}
Wir schauen uns nun mal den Ablauf des Scriptes an, und zwar an einem einfachen Array. Dieses Array sieht folgendermaßen aus:
{{ScriptCode|<nowiki>$Testarray = ARRAY (3, 5, 7)</nowiki>}}
'''Wir merken uns:'''Die 3 steht an Index 0; die 5 steht an Index 1; die 7 steht an Index 2. Nun führen wir das Script aus:
*Zuerst wird die Größe des Arrays ausgelesen. Das Array hat 3 Indizes, also ist die Variable $zaehler nun = 3.
*Jetzt kommt die Prüfung: while $zaehler > 0. Die Variable hat den Wert 3, das ist größer 0, also wird die Schleife ausgeführt.
*Nun wird $zaehler um 1 erniedrigt, die Variable hat also jetzt den Wert 2.
*Jetzt wird der Wert ausgelesen, und als Index wird hier $zaehler verwendet. Diese Variable hat den Wert 2, also wird der zweite Index genommen. Am zweiten Index steht jetzt die 7, die Variable $array.wert hat nun also den Wert 7.
*Der "wait"-Befehl dient nur zur Schonung der Performance.
*Das end definiert das Ende der Schleife, nun wird also wieder zur Einstiegsbedingung zurückgekehrt.
*Wieder die Prüfung, $zaehler ist 2, und da 2 > 0 ist die Bedingung erfüllt.
*Anschließend wird $zaehler um 1 erniedrigt, hat jetzt also den Wert 1.
*Jetzt wird wieder der Arraywert ausgelesen, und zwar nun am Index nr. 1. Die Variable $array.wert hat jetzt also den Wert 5.
*wait und end dürften bekannt sein, also wieder zur Bedingung nach oben.
*$zaehler hat den Wert 1, und 1 > 0 , also ist die Bedingung erfüllt.
*$zaehler wird um 1 erniedrigt, hat also jetzt den Wert 0.
*wieder wird ausgelesen, und zwar am Index 0. Die Variable $array.wert hat nun den Wert 3.
*wieder wait und end, nun zurück zur Bedingung
*$zaehler hat nun den Wert 0. Nun wird geprüft, ob $zaehler > 0 ist, also wird geprüft, ob 0 > 0 ist. Das ist jedoch nicht der Fall, und so wird die Schleife nun nicht mehr durchlaufen.

Jetzt wurden alle Werte im Array ausgelesen.

← Nächstältere Version		Version vom 20. August 2011, 01:10 Uhr
Zeile 3:		Zeile 3:
	{{TutorialBar2\|[[Selbstausführende Scripts]]\| "[[X3:Terran Conflict Scripting-Tutorial]]"\|[[Objekte erstellen]]}}		{{TutorialBar2\|[[Selbstausführende Scripts]]\| "[[X3:Terran Conflict Scripting-Tutorial]]"\|[[Objekte erstellen]]}}

	Nun soll es um Arrays gehen. Die Arrays braucht man relativ häufig beim Scripten in ~~X3TC~~, da sie eine wichtige Variablenform darstellen. <br>		Nun soll es um Arrays gehen. Die Arrays braucht man relativ häufig beim Scripten in X³: TC, da sie eine wichtige Variablenform darstellen.<br>
	Die meisten der ~~Scriptbefehle~~ zu Arrays finden sich unter: "General Commands" -> "Arrays"		Die meisten der Script-Befehle zu Arrays finden sich unter: "General Commands" -> "Arrays"

	==Was ist ein Array?==		==Was ist ein Array?==
	Ein Array ist erst einmal nur eine Variable, jedoch eine ganz besondere. Eine normale Variable kann nur einen Wert aufnehmen, z.B. eine Zahl, einen Namen, eine Schiffsklasse einen Sektor etc. <br>		Ein Array ist erst einmal nur eine Variable, jedoch eine ganz besondere. Eine normale Variable kann nur einen Wert aufnehmen, z.B. eine Zahl, einen Namen, eine Schiffsklasse einen Sektor etc.<br>
	Ein Array kann jedoch mehrere Werte in sich aufnehmen. Hierzu nutzt es sogenannte Indizes, an denen die einzelnen Werte gespeichert werden. Die einzelnen Werte können auch verschieden sein, man kann also durchaus Zahlen zusammen mit Schiffen in ein Array packen. Man kann auch mehrere Arrays ineinander packen, dies macht vor allem bei Flottenverbänden für die KI einen Sinn.		Ein Array kann jedoch mehrere Werte in sich aufnehmen. Hierzu nutzt es sogenannte Indizes, an denen die einzelnen Werte gespeichert werden. Die einzelnen Werte können auch verschieden sein, man kann also durchaus Zahlen zusammen mit Schiffen in ein Array packen. Man kann auch mehrere Arrays ineinander packen, dies macht vor allem bei Flottenverbänden für die KI einen Sinn.

Zeile 13:		Zeile 13:
	Wir schauen uns zunächst einmal den Grundcode eines Arrays an. Der sieht folgendermaßen aus:		Wir schauen uns zunächst einmal den Grundcode eines Arrays an. Der sieht folgendermaßen aus:
	{{ScriptCode\|<nowiki>ARRAY (Buster, 1, 'Hallo', Erzgürtel, Energiezellen, {{Bewegliches Schiff}} )</nowiki>}}		{{ScriptCode\|<nowiki>ARRAY (Buster, 1, 'Hallo', Erzgürtel, Energiezellen, {{Bewegliches Schiff}} )</nowiki>}}
	So sieht ein Array aus. Nun wollen wir uns das ganze mal detaillierter anschauen:		So sieht ein Array aus. Nun wollen wir uns das ganze mal detaillierter anschauen:

	An erster Stelle steht das Wort ARRAY. Dieses dient im Grunde nur dazu, damit man weiß, dass es sich um ein Array handelt. In den Klammern stehen nun die im Array enthaltenen Werte. <br>		An erster Stelle steht das Wort ARRAY. Dieses dient im Grunde nur dazu, damit man weiß, dass es sich um ein Array handelt. In den Klammern stehen nun die im Array enthaltenen Werte. <br>
	Die einzelnen Werte sind durch Kommata voneinander getrennt. Die Kommata markieren die einzelnen Indizes. '''Wichtig:''' Der erste Index (hier ist dort "Buster" gespeichert) hat die Nummer 0, und nicht die 1.		Die einzelnen Werte sind durch Kommata voneinander getrennt. Die Kommata markieren die einzelnen Indizes. '''Wichtig:''' Der erste Index (hier ist dort "Buster" gespeichert) hat die Nummer 0, und nicht die 1.

	==Wie lese ich ein Array aus?==		==Wie lese ich ein Array aus?==

	Die Werte aus dem Array kann man nun per Code abfragen. Dazu verwendet man den Namen des Arrays, gefolgt von der Nummer des Index, die in eckigen Klammern geschrieben wird. Wir nennen unser Array nun einmal "Testarray", und fragen nun die Werte ab. <br>		Die Werte aus dem Array kann man nun per Code abfragen. Dazu verwendet man den Namen des Arrays, gefolgt von der Nummer des Index, die in eckigen Klammern geschrieben wird. Wir nennen unser Array nun einmal "Testarray", und fragen nun die Werte ab.<br>
	Wir möchten nun den Wert "Energiezellen" aus dem Array auslesen. Dieser steht an fünfter Stelle im Array, doch da der erste Index die Nummer 0 hat, stehen die Energiezellen an Index Nummer 4.		Wir möchten nun den Wert "Energiezellen" aus dem Array auslesen. Dieser steht an fünfter Stelle im Array, doch da der erste Index die Nummer 0 hat, stehen die Energiezellen an Index Nummer 4.

	Der Befehl sieht nun folgendermaßen aus:		Der Befehl sieht nun folgendermaßen aus:
Zeile 34:		Zeile 34:
	Man kann so ein Array jetzt auch systematisch auslesen. Dies macht man mit der "while-Schleife", die schon vorher erklärt wurde.		Man kann so ein Array jetzt auch systematisch auslesen. Dies macht man mit der "while-Schleife", die schon vorher erklärt wurde.

	'''Vorgehensweise:''' <br>		'''Vorgehensweise:'''<br>
	Das Script soll nun folgendes machen:		Das Script soll nun folgendes machen:
	*Größe des Arrays ermitteln		*Größe des Arrays ermitteln
Zeile 52:		Zeile 52:
	<nowiki>=wait 10ms</nowiki><br>		<nowiki>=wait 10ms</nowiki><br>
	<nowiki>end</nowiki>}}		<nowiki>end</nowiki>}}
	Wir schauen uns nun mal den Ablauf des Scriptes an, und zwar an einem einfachen Array. Dieses Array sieht folgendermaßen aus:		Wir schauen uns nun mal den Ablauf des Scriptes an, und zwar an einem einfachen Array. Dieses Array sieht folgendermaßen aus:
	{{ScriptCode\|<nowiki>$Testarray = ARRAY (3, 5, 7)</nowiki>}}		{{ScriptCode\|<nowiki>$Testarray = ARRAY (3, 5, 7)</nowiki>}}
	'''Wir merken uns:'''Die 3 steht an Index 0; die 5 ~~steht~~ an Index 1; die 7 ~~steht~~ an Index 2. Nun führen wir das Script aus:		'''Wir merken uns:'''Die 3 steht an Index 0; die 5 an Index 1; die 7 an Index 2. Nun führen wir das Script aus:
	*Zuerst wird die Größe des Arrays ausgelesen. Das Array hat 3 Indizes, also ist die Variable $zaehler nun = 3.		*Zuerst wird die Größe des Arrays ausgelesen. Das Array hat 3 Indizes, also ist die Variable $zaehler nun = 3.
	*Jetzt kommt die Prüfung: while $zaehler > 0. Die Variable hat den Wert 3, das ist größer 0, also wird die Schleife ausgeführt.		*Jetzt kommt die Prüfung: while $zaehler > 0. Die Variable hat den Wert 3, das ist größer 0, also wird die Schleife ausgeführt.
	*Nun wird $zaehler um 1 erniedrigt, die Variable hat also jetzt den Wert 2.		*Nun wird $zaehler um 1 erniedrigt, die Variable hat also jetzt den Wert 2.
Zeile 63:		Zeile 63:
	*Wieder die Prüfung, $zaehler ist 2, und da 2 > 0 ist die Bedingung erfüllt.		*Wieder die Prüfung, $zaehler ist 2, und da 2 > 0 ist die Bedingung erfüllt.
	*Anschließend wird $zaehler um 1 erniedrigt, hat jetzt also den Wert 1.		*Anschließend wird $zaehler um 1 erniedrigt, hat jetzt also den Wert 1.
	*Jetzt wird wieder der Arraywert ausgelesen, und zwar nun am Index nr. 1. Die Variable $array.wert hat jetzt also den Wert 5.		*Jetzt wird wieder der Arraywert ausgelesen, und zwar nun am Index Nr. 1. Die Variable $array.wert hat jetzt also den Wert 5.
	*wait und end dürften bekannt sein, also wieder zur Bedingung nach oben.		*wait und end dürften bekannt sein, also wieder zur Bedingung nach oben.
	*$zaehler hat den Wert 1, und 1 > 0 , also ist die Bedingung erfüllt.		*$zaehler hat den Wert 1, und 1 > 0 , also ist die Bedingung erfüllt.
Zeile 74:		Zeile 74:

	==Arrays selber erstellen==		==Arrays selber erstellen==
	Man kann Arrays auch selbst erstellen. Dazu muss zunächst ein ~~Grundlegendes~~ Array erstellt werden. Das macht man mit dem Befehl:		Man kann Arrays auch selbst erstellen. Dazu muss zunächst ein grundlegendes Array erstellt werden. Das macht man mit dem Befehl:
	{{ScriptCode\|<nowiki><RetVar> = array alloc: size=<Var/Number></nowiki>}}		{{ScriptCode\|<nowiki><RetVar> = array alloc: size=<Var/Number></nowiki>}}
	Unter "<nowiki><RetVar></nowiki>" kann der Name des Arrays eingestellt werden. Wir nennen unseres einfach mal "Testarray". Unter <nowiki>"size=<Var/Number>"</nowiki> kann die Größe des Arrays eingestellt werden.		Unter "<nowiki><RetVar></nowiki>" kann der Name des Arrays eingestellt werden. Wir nennen unseres einfach mal "Testarray". Unter <nowiki>"size=<Var/Number>"</nowiki> kann die Größe des Arrays eingestellt werden.

	Beim Festlegen der Größe gibt es 2 Möglichkeiten: Einmal kann man hier eine feste Größe vorgeben und dann die einzelnen Indizes mit Werten bestücken, oder man erstellt ein Array mit der Größe 0, also mit keinem einzigen Index, und fügt dann mittels "append" die Werte hinzu. Obwohl letztere Methode fast immer praktischer ist, werden im Folgenden beide Methoden erklärt.		Beim Festlegen der Größe gibt es 2 Möglichkeiten: Einmal kann man hier eine feste Größe vorgeben und dann die einzelnen Indizes mit Werten bestücken, oder man erstellt ein Array mit der Größe 0, also mit keinem einzigen Index, und fügt dann mittels "append" die Werte hinzu. Obwohl letztere Methode fast immer praktischer ist, werden im Folgenden beide Methoden erklärt.

	===Erstellen eines Arrays mit fester Größe===		===Erstellen eines Arrays mit fester Größe===
	Hierzu erstellen wir mit dem oben genannten Befehl einfach das Array. Als Beispiel wollen wir 5 Indizes haben, also erstellen wir ein Array der Größe 5. Beachtet, dass dabei dann die Indizes von 0-4 vergeben werden können. So sieht der Befehl aus:		Hierzu erstellen wir mit dem oben genannten Befehl einfach das Array. Als Beispiel wollen wir 5 Indizes haben, also erstellen wir ein Array der Größe 5. Beachtet, dass dabei dann die Indizes von 0-4 vergeben werden können. So sieht der Befehl aus:
	{{ScriptCode\|<nowiki>$Testarray = array alloc: size=5</nowiki>}}		{{ScriptCode\|<nowiki>$Testarray = array alloc: size=5</nowiki>}}
	Nun haben wir ein Array erstellt, bei dem wir die Indizes 0-4 vergeben können. Als Beispiel wollen wir nun wieder das Array erstellen, und danach den Index Nummer 3 mit dem Wert "1" bestücken. Das sieht dann folgendermaßen aus:		Nun haben wir ein Array erstellt bei dem wir die Indizes 0-4 vergeben können. Als Beispiel wollen wir nun wieder das Array erstellen, und danach den Index Nummer 3 mit dem Wert "1" bestücken. Das sieht dann folgendermaßen aus:
	{{ScriptCode\|<nowiki>$Testarray = array alloc: size=5</nowiki><br>		{{ScriptCode\|<nowiki>$Testarray = array alloc: size=5</nowiki><br>
	<nowiki>$Testarray[3]=1</nowiki>}}		<nowiki>$Testarray[3]=1</nowiki>}}
Zeile 91:		Zeile 91:
	Hierzu erstellt man das Array mit der Größe 0. Also sieht die erste Zeile des Codes so aus:		Hierzu erstellt man das Array mit der Größe 0. Also sieht die erste Zeile des Codes so aus:
	{{ScriptCode\|<nowiki>$Testarray = array alloc: size=0</nowiki>}}		{{ScriptCode\|<nowiki>$Testarray = array alloc: size=0</nowiki>}}
	Nun haben wir ein komplett leeres Array.		Nun haben wir ein komplett leeres Array.

	Die Methode "append" macht nichts anderes, als am Ende des Arrays einen weiteren Index dranzuhängen. Das heißt, wenn ich ein Array habe mit den Indizes 0-4, und ich nehme "append", dann wird ein neuer Index hinten angehängt.		Die Methode "append" macht nichts anderes, als am Ende des Arrays einen weiteren Index dranzuhängen. Das heißt, wenn ich ein Array habe mit den Indizes 0-4, und ich nehme "append", dann wird ein neuer Index hinten angehängt.

	Wir fügen nun mittels "append" unserem Array die Zahl 84 hinzu. So sieht das dann aus:		Wir fügen nun mittels "append" unserem Array die Zahl 84 hinzu. So sieht das dann aus:
	{{ScriptCode\|<nowiki>append 84 to array $Testarray</nowiki>}}		{{ScriptCode\|<nowiki>append 84 to array $Testarray</nowiki>}}
	Nun wird ein Index an das Array ~~drangehängt~~, der den Wert 84 beinhaltet.		Nun wird ein Index an das Array angehängt, der den Wert 84 beinhaltet.

	Unser gesamtes Array sieht nun so aus:		Unser gesamtes Array sieht nun so aus:
	{{ScriptCode\|<nowiki>ARRAY (null, null, null, 1, null, 84)</nowiki>}}		{{ScriptCode\|<nowiki>ARRAY (null, null, null, 1, null, 84)</nowiki>}}
	Wie man hier sieht, steht dort öfters mal der Ausdruck "null". Der sagt einfach nur aus, dass an dem Index noch nichts ist, er steht also nicht für die Zahl 0, sondern eher für "nichts".		Wie man hier sieht, steht dort öfters mal der Ausdruck "null". Der sagt einfach nur aus, dass an dem Index noch nichts ist, er steht also nicht für die Zahl 0, sondern eher für "nichts".