Vorlage Dokumentationwrite()
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

write()

Schreiben eines Values in eine geöffnete Datei

Syntax

<int>=write(<handle>,<val>)

Beschreibung

Die Funktion dient dazu, bel. Variablen in eine Datei zu schreiben. Sie bedient sich dazu einer an XML angelehnten Syntax (genaugenommen eine Untermenge von XML; um eine gültige XML-Datei zu erhalten, muß man also nur einen Kopf und den Document-Root davor bzw. dahinter schreiben). Der Rückgabewert ist 0, wenn das Schreiben fehlschlug.

Parameter

handle Datei-Handle einer zum Schreiben geöffneten Datei
val Wert bel. Typs, auch Behälter, der geschrieben werden soll

Beispiel

#var $handle $rc
#dict $dict
$dict['foo']='Zerfretelter Grunzwanzling'
$dict['bar']=3.1415
$handle=open('test.xml',MODE_WRITE)
#if STAT_OK==status($handle)
{
    $rc=write($handle,$dict)
    #if $rc==0
    {
        #debug 'Schreiben hat nicht geklappt:'+statustext($handle)
    }
}
$rc=close($handle)

Das erzeugt, wenn kein Fehler auftritt, eine Datei test.xml mit dem Inhalt:

<dic>
 <pair id="bar">
  <str>Zerfretelter Grunzwanzling</str>
 </pair>
 <pair id="foo">
  <flt>3.1415</flt>
 </pair>
</dic>

Referenzen

read()

Revision 18 Nov 2004

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