Vorlage Dokumentation#config
Allgemeines
   Aufruf
   Einleitung
   Installation
   Konfiguration
   Syntax
Einführung
   MetabefehlsAusdruecke
   MetabefehlsSyntax
   RegulaereAusdruecke
   VordefinierteVariablen
Funktionen
   abs()
   after()
   and()
   antoi()
   before()
   ceil()
   change()
   close()
   crop()
   equals()
   exp()
   flatten()
   float()
   floor()
   int()
   isnothing()
   itoan()
   length()
   log()
   log10()
   match()
   not()
   open()
   or()
   random()
   read()
   readline()
   sign()
   status()
   statustext()
   substr()
   system()
   time()
   tolower()
   toupper()
   typeof()
   write()
   writeline()
   xname()
   xor()
Metabefehle
   #after
   #array
   #break
   #call
   #config
   #const
   #debug
   #default
   #dict
   #else
   #every
   #forever
   #func
   #if
   #ifregion
   #ifunit
   #include
   #input
   #message
   #next
   #notrace
   #proc
   #return
   #sort
   #table
   #tag
   #trace
   #var
   #while
Rückruf-Prozeduren
   CalcUnitCapacities
   CreateRegionHeader
   CreateUnitHeader
   EndRegion
   EndUnit
   OnBuilding
   OnExit
   OnInit
   OnRegion
   OnShip
   OnUnit
   OutputLineFilter
Report-Objekte
   building
   grenze
   partei
   preise
   races
   region
   report
   ship
   things
   unit
Anhang
   Danksagungen
   SkriptDebugger
   VorlageFAQ

#config

Einlesen von Konfigurationsdaten als Objekt

Syntax 

#config <Kapitel> [FILE <Datei>] <Mode> [<Spalten> ...]

Beschreibung

Der Befehl kann Tabellen aus dem Config-File in globale Objekte laden. Wichtig ist, das der Dateiname ein String ist, also in Hochkommas eingefasst werden sollte. Dabei gibt es drei Modes die Tabellenformaten im Config-File entsprechen.

Parameter

Kapitel Selektiert das Konfigurations-Datei-Kapitel das die Tabelle enthält
Datei Gibt an, das statt der normalen Konfigurationsdatei die hier angegebene verwendet werden soll
Mode Dieser Parameter gibt an wie die Tabelle in ein Objekt überführt werden soll.
Spalten Hier werden die für den Modus TABH vorgesehenen Spaltennamen als Attributsnamen angegeben.

Es werden folgende Modi unterstützt:

TABH

Horizontale Objekt-Anordnung, d.h. alle Attribute in einer Zeile (z.b. Castles oder Things im Config-File).

Hier müssen die Attributnamen, ohne die erste Spalte, angegeben werden, die erste Spalte ist Index und kann auch als Attribut NAME erfragt werden

Beispiel: 

#config Castles tabh groesse bonus

erzeugt mit eressea.cfg ein Object bei dem der Aufruf 

CASTLES['Festung'].GROESSE

250 ergibt

TABV

Vertikale Objekt-Anordnung, d.h. alle Attribute in einer Spalte (z.b. Races im Config-File). Hier sind die Attributnamen in der ersten Spalte, die erste Zeile ist Index und kann als Attribut NAME erfragt werden.

Beispiel: 

#config Races tabv

erzeugt ein Object RACES welches sich genau so verhält wie das eingebaute, welches wohl mittelfristig entfernt wird

NESTED

Verschachteltes Object, mit einer Ebene Unterobjekten, d.h. das Objekt ist Komplett in einer Zeile angegeben, aber mit einem speziellen Aufbau: Erster Eintrag ist der Index, der auch unter NAME erreichbar ist, dann folgt eine Kette von Subobjekten die immer durch den Subobjekt-Namen gefolgt von den Attributen als Zahl/Namens-Paare aufgelistet werden. Dieser Aufbau impliziert, das nur Numerische Attribute möglich sind

Beispiel: 

#config Buildings nested

erzeugt ein Object BUILDINGS bei welchem der Aufruf 

BUILDINGS['Saegewerk'].BAUKOSTEN.STEIN

den Wert 5 ergibt

Beispiel

Um aus einer Datei ../configs/meineconfig.cfg die Tabelle [MeinKapitel] in Objekte mit den Attributen x, y und z zu laden, benutzt man: 

#config MeinKapitel FILE '../configs/meineconfig.cfg' TABH x y z

Referenzen

Installation

Revision 09 May 2003

Page design, graphics and contents (c) copyright 1999-2004
by S.Schümann and contributing authors