obj_save

obj_save speichert ein Objekt in einer Datei oder in einer Zeichenkette.

ret = obj_save(obj, ssFilename)

ret = obj_save(obj, ssFilename, ssFormat)

Returnwert

Falls ssFilename ein vollständiger Dateiname ist, ist ret ungleich 0, wenn die Funktion erfolgreich war und 0 wenn die Funktion fehlgeschlagen ist. Falls ssFilename ein leerer String (“”) ist, ist ret ein String mit dem XML-Code des Objekts obj.

Parameter

obj

obj ist ein mit obj_create erzeugtes Objekt.

ssFilename

ssFilename ist der komplette Dateiname oder ein leerer String (“”) (siehe ret).

ssFormat

ssFormat ist ein Format-String der angibt, wie Zahlen gespeichert werden sollen (siehe printf). Der Default-Wert ist "%.20g".

Beispiel

obj = obj_create()
obj[1] = 123
obj.a = "Hello"
obj.c = obj_create()
obj.c.d = 456
obj.save("d:/test.xml")

erzeugt die folgende xml-Datei:

<?xml version='1.0' encoding='utf-8'?>
<obj id='1'>
    <number ikey='1'>123</number>
    <string key='a'>Hello</string>
    <obj id='2' key='c'>
        <number key='d'>456</number>
    </obj>
</obj>

Kommentar

Die Funktion kann auch Objekte speichern, die zyklische Referenzen enthalten, z. B.

obj = obj_create()
obj.val = 123
obj.next = obj_create()
obj.next.val = 456
obj.next.next = obj
obj.save

erzeugt folgende Datei (beachte Attribute id und ref):

<?xml version='1.0' encoding='utf-8'?>
<obj id='1'>
    <obj id='2' key='next'>
        <obj key='next' ref='1'/>
        <number key='val'>456</number>
    </obj>
    <number key='val'>123</number>
</obj>

History

Version	Beschreibung
5.10.0	Für den Dateinamen kann ein leerer String angegeben werden.
5.0.0	Unicode-Änderungen
4.1.0	Neu

Siehe auch

Überblick UniScript Objekte, obj_load, obj_copy

_id-699932