STNE-Wiki - Benutzerbeiträge [de]

API:CDataNodeStorage

2024-10-09T08:28:20Z

GulFaldrian: Erlaubte Zeichen von Datenbanknamen ergänzt

{{Vorlage:ApiMenu}}

== Allgemein ==

{{Code|CDataNodeStorage}} ermöglicht es, Daten dauerhaft zu speichern. Diese sind dann auch noch vorhanden, wenn das Script nicht gerade ausgeführt wird. Mögliche Daten sind Texte ([[API:String|Strings]]) und Zahlen (z.B. [[API:Integer|Integer]]).

Zum Einrichten einer Datenbank ist lediglich folgende Zeile nötig:

{{Code|Var Speicher As New CDataNodeStorage('ScriptName_Speicher', 1);}}

Wenn als zweiter Parameter eine 1 gesetzt ist, wird unter Datenbank->Scripting->Daten ein neuer Eintrag mit dem Namen des ersten Parameters (hier: ScriptName_Speicher) erstellt. Dieser lässt sich auch nicht wieder löschen. Überlege dir also vorher, ob du eine Datenbank anlegen willst.

Der '''Name''' der Datenbankdatei (hier 'ScriptName_Speicher') darf nur aus bestimmten Zeichen bestehen. Namen bestehend aus den Zeichen {{Code|A-Z}}, {{Code|a-z}}, {{Code|0-9}} und {{Code|_}} scheinen gültig zu sein.

Mit der Variable ''Speicher'' kannst du nun auf die Datenbank zugreifen und Werte reinschreiben.

Beispiel:

{{Code|Speicher.Items.Add('Knoten');}}

Damit wird in der Datenbank ein neuer Knoten mit dem Namen ''Knoten'' angelegt.

''Beachte: Speicher.Items gibt ein Objekt des Typs [[API:CDataNodeList|CDataNodeList]] zurück! Darin sind alle Elemente der obersten Ebene der Datenbank enthalten.''

== Struktur ==

Die Struktur der Datenbank ist folgendermaßen aufgebaut:

Knoten
{
KindKnoten1
{
KindKindKnoten='Wert1';
}
KindKnoten2='Wert2';
}

Das Anlegen der oben gezeigten Struktur funktioniert so:

Speicher.Items.Add('Knoten');
Speicher.Item('Knoten').Items.Add('KindKnoten1');
Speicher.Item('Knoten').Items.Add('KindKnoten2');
Speicher.Item('Knoten').Items.Item('KindKnoten1').Items.Add('KindKindKnoten');
Speicher.Item('Knoten').Items.Item('KindKnoten1').Items.Item('KindKindKnoten').Value = 'Wert1';
Speicher.Item('Knoten').Items.Item('KindKnoten2').Value = 'Wert2';

Das mag natürlich auf den ersten Blick noch etwas verwirrend sein, deshalb jetzt Schritt für Schritt:

- In der ersten Zeile wird der obersten Ebene der Datenbank der Knoten 'Knoten' hinzugefügt.

- In der zweiten Zeile wird nun der gerade neu erstellten Ebene 'Knoten' ein Knoten hinzugefügt ('KindKnoten1') und somit eine neue Ebene erstellt.

- In der dritten Zeile passiert wieder das Gleiche, nur dass diesmal ein zweiter Knoten in die gleiche Ebene wie KindKnoten1 eingefügt wird.

- In der vierten Zeile wir eine weitere Ebene eingefügt, diesmal als Unterebene von 'KindKnoten1'.

- In der fünften Zeile wird dem 'KindKindKnoten' der Wert "Wert1" zugewiesen.

- In der letzten Zeile wird schließlich dem Knoten 'KindKnoten2' der Wert "Wert2" zugewiesen.

Jeder Knoten in der Datenbank kann einen Wert haben. Es muss aber keiner eingetragen werden. Um einen Wert auszulesen verfährt man ähnlich wie beim Eintragen eines Wertes:
{{Code|Speicher.Item('Knoten').Items.Item('KindKnoten2').Value;}}

gibt den Wert "Wert2" zurück, welcher im Script wie gewohnt verwendet werden kann.

Für eine detailliertere Beschreibung, was man mit der Datenbank so alles machen kann, schau dir den Eintrag zur [[API:CDataNodeList|CDataNodeList]] an, sowie [[API:CDataNode|CDataNode]]

== Methoden ==

Die wichtigsten Eigenschaften oder Methoden sind die folgenden:
{| cellpadding="4"
! Methode !! Erklärung
|-
| Copy || Kopiert die Datenbank und erstellt eine neue mit dem angegebenem Namen
|-
| Delete || Löscht den '''Inhalt''' der Datenbank
|-
| Items || Gibt ein Objekt des Typs [[API:CDataNodeList|CDataNodeList]] zurück ('''wichtigster Parameter''')
|-
| LoadFromUser || Damit kann man eine Datenbank von einem anderen User laden, wenn diese freigegben wurde. ACHTUNG: Fehlermeldung wenn die Datenbank nicht existiert!
|-
| Rename || Ändert den Namen der Datenbank
|}
Die vollständige Liste findest du direkt im Objektexplorer unter (http://game.stne.net/ObjectExplorer.aspx?p=CDataNodeStorage)

--[[Spieler:SimonSlater|SimonSlater]] 16:28, 20. Aug. 2010 (CEST)

Spieler:GulFaldrian

2023-12-04T16:02:25Z

GulFaldrian: Die Seite wurde neu angelegt: „Moin! Im Spiel findet ihr mich unter der ID 76759.“

Moin!

Im Spiel findet ihr mich unter der ID 76759.

Lapsus

2023-12-04T16:01:15Z

GulFaldrian: Verweis auf die Berechnungsformel aus den STNE News ergänzt

{{Schiffsmenue}}
{| cellspacing="0" style="float:right;margin-left:3em"
! Lapsus
|-
| align="center" | http://game.stne.net/i/s/14.gif 
Lapsus
|-
! style="border-bottom:0px" | '''Daten'''
|-
| class="nl" style="padding:0px" |
{| width="100%"
|-
| rowspan="2" |
''[[Schiffsklassifikationen|Klassifikation]]:''
| [[:Kategorie:Nicht eindeutig zugeordnete Schiffe|nicht eindeutig zugewiesen]]
|-
| [[:Kategorie:Erkundungsschiffe|Erkundungsschiff]] [[:Kategorie:Schiffe mit speziellen Funktionen|SpezialFunktion]]: 
* [[Subraumhorchen]]
* Weltraumgleiter
|}
|-
! style="border-top:0px; border-bottom:0px" | '''Eigenschaften'''
|-
| class="nl" style="padding:0px" |
{| width="100%"
|-
| ''[[Schiffslimit|Slots:]]'' || 3,5
|-
| ''[[Crew|Max. Crew (Basis-Crew):]]'' || 15 (10)
|-
| ''[[Hülle|Hüllenstärke:]]'' || 50
|-
| ''[[Panzerung|Panzerung:]]'' || 0
|-
| ''[[Schilde|Schildstärke:]]'' || 10
|-
| ''[[Schiffs-EPS|EPS-Speicher:]]'' || 120
|-
| ''[[Hauptenergie|Hauptenergie:]]'' || 300
|-
| ''[[Reaktor|Reaktorleistung:]]'' || 55 {}
|-
| ''[[Reaktor|Kernkapazität:]]'' || 1500
|-
| ''[[Gondeln|Gondeln:]]'' || 80
|-
| ''[[Flugkosten|Flugkosten:]]'' || 0,8
|-
| ''[[Cargo|Frachtraum:]]'' || 50
|-
| ''[[Beamen|Beam-Kapazität:]]'' || 10
|-
| ''[[Kampfsystem|Waffen:]]'' ||
* Phaser: 10|10 -85%
* Ausweichen: 15%
|-
| ''[[LRS-Reichweite|LRS-Reichweite:]]'' || 5
|-
| ''[[Subraumhorchen]]'' || ja
|-
| ''[[Deflektor|Deflektor:]]'' || 80 / 10
|}

|-
! style="border-top:0px" | '''Notwendige Forschung'''
|-
|
[[Weltraumgleiter-Konstruktion|Weltraumgleiter]]
{|
|class="nl"| ''Forschungskosten:''
|class="nl"| 500 [[Iso-Chips|Iso-Chips]]
|}

|-
! '''Baukosten'''
|-
|
* 152 [[Baumaterial|Baumaterial]]
* 260 [[Duranium|Duranium]]
* 100 [[Deuterium|Deuterium]]
* 15 [[Antimaterie|Antimaterie]]
* 40 [[Iso-Chips|Iso-Chips]]
* 20 [[Dilithium|Dilithium]]
* 10 [[Tritanium|Tritanium]]
{|
|class="nl"| ''Bauzeit:''
|class="nl"| 11 [[Tick|Ticks]]
|}
|-
|class="nl"| 
|}
'''Lapsus''' 
 
Dieses Schiff ist in der Lage die Flottenbewegungen der letzten 5 Tage durch das Auslesen von Subraumveränderungen nachzuvollziehen. Im Vergleich zum [[Patrouillenschiff]] besticht dieser Schiffstyp durch eine um 30 % höhere Reichweite. 
 
Die Fähigkeit "Weltraumgleiter" ermöglicht es dem Schiff zusätzlich, Schiffsspuren auf der "Schiffsaktivität-Sternenkarte" zu verfolgen. Hierbei verbraucht das Schiff durchschnittlich weniger Flugreichweitenkapazität (Gondeln) als herkömmliche Schiffe. Mehr Informationen zu der Berechnung der Gondelkosten sind in der "STNE News" vom 31.05.2015 - 19:43 mit dem Titel "Weltraumgleiter" zu finden (in Datenbank -> News Archiv).
 
 
 
{{seealso}}
* [[Weltraumgleiter-Konstruktion|Weltraumgleiter]] (Forschung)
* [[Siedlerschiffe]]
 
 
 
[[Kategorie:Schiffe]]
[[Kategorie:Bauschiffe]]
[[Kategorie:Nicht eindeutig zugeordnete Schiffe]]
[[Kategorie:Schiffe mit speziellen Funktionen]]
[[Kategorie:Erkundungsschiffe]]