Vorlage Dokumentation#dict
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

#dict

Deklaration von Dictionaries

Syntax

#dict $Dict1 [$Dict2 [$Dict3 [...]]]

Beschreibung

Mittels dieses Befehls kann man Dictionaries erzeugen. Ein Dictionary ist ein Behälter von Werten die über einen frei wählbaren Schlüssel von (fast) beliebigem Typ anzusprechen sind.

Auf den Behälter kann mittels '$DictName[key]' zugegriffen werden. Neue Elemente fügt man in ein Dictionary ein, indem man sie über den Schlüssel mittels '$DictName[key]' zuweist.

Man kann den Schlüssel des $n-ten Elements mittels '$DictName($n)' erhalten, also auf das $n-te Element mittels '$DictName[$DictName($n)]' zugreifen. Achtung: Diese Methode ist extrem aufwändig, da $n interne Schritte nötig sind um den Key des $n-ten Elements zu erhalten.

Elemente kann man, analog zu Arrays mittels '$DictName[key]=' löschen.

Die Größe (Anzahl der Elemente) in einem Dictionary kann man durch '$DictName.size' ermitteln.

Legt man ein Dirctionary außerhalb von Funktionen oder Prozeduren an, so ist es global, d.h. von allen Funktionen, Prozeduren und den eingebetteten Befehlen der Einheiten aus sichtbar. Legt an es innerhalb der Funktionen oder Prozeduren an, so ist die Sichtbarkeit auf die betreffende beschränkt und es wird nach Verlassen gelöscht.

Achtung: Es ist nicht möglich #dict innerhalb der Zugvorlage (bzw. dem CR) zu verwenden.

Parameter

$Dict1, $Dict2, $Dict3 Bezeichner der Dictionaries die angelegt werden sollen. Groß- und Kleinschreibung wird unterschieden.

Beispiel

#dict $regionsDaten

#func initRegion

{

$regionsDaten[''region.x+'/'+region.y+'/'+region.z]=[region.name,region.bauern]

#return 1

}

Das Dict $regionsDaten wird mit einem Array befüllt.

Referenzen

#array, #var

Revision 20 Jun 2005

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