.. highlightlang:: us

.. index:: obj_load

.. _obj_load:

obj_load
========

.. us.tag  obj_load NOTREADYGERMAN obj New410 Changed5100 Changed5603

:ref:`obj_load` lädt ein mit :ref:`obj_save` gespeichertes Objekt aus einer Datei 
oder aus einem String.

.. function::  e = obj_load(obj, ssFilename)
               e = obj_load(obj, ssString)
               e = obj_load(obj, ssFilenameOrString, bString)

.. us.return

**Returnwert**

*e* ist ein Error-Objekt (siehe :ref:`error_create`) wenn ein Fehler aufgetreten
ist, oder 0 wenn kein Fehler aufgetreten ist.

.. us.params

**Parameter**

.. uparam:: obj

   *obj* ist ein mit :ref:`obj_create` erzeugtes Objekt.

.. uparam:: ssFilename

   *ssFilename* ist der komplette Dateiname des mit :ref:`obj_save` gespeicherten
   Objekts. 

.. uparam:: ssFileOrString

   *ssFileOrString* ist der komplette Dateiname des mit :ref:`obj_save` 
   gespeicherten Objekts oder ein String mit dem XML-Code des Objekts. 

.. uparam:: bString

   Falls *bString* TRUE (1) muss *ssFileOrString* den XML-Code des Objekts
   enthalten, sonst einen Dateinamen.

.. us.example

**Beispiel**

::

   obj = obj_create()
   obj.a = 123
   obj.b = "Hello"
   obj.save("c:/test.xml");
   obj2 = obj_create()
   e = obj2.load("c:/test.xml")
   if (e) {
       MessageBoxError(e.message);
   }

Beispiel 2:

.. highlight:: none

::

   * o = [. a = 123, "Hello"]
   * o
   [.
       [1] = "Hello"
       a = 123
   ]
   object (obj at 0x3E0DB38)
   * r = o.save("")
   * r
   <?xml version='1.0'  encoding='utf-8'?>
   <obj id='1'>
   <string ikey='1'>Hello</string>
   <number key='a'>123</number>
   </obj>

   * o1 = [.]
   * o1.load(r, 1)
       0.0000 
   * o1
   [.
       [1] = "Hello"
       a = 123
   ]

.. highlight:: us

.. us.comment

**Kommentar**

Die Funktion kann auch mit :ref:`MapSave` gespeicherte Map-Dateien laden.

Die in der Datei gespeicherten Elemente werden in das Objekt geladen. Bereits
vorhandene Elemente werden beim Laden überschrieben. Nicht in der Datei
enthaltene Elemente bleiben erhalten.

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - R2014.3
     - Es können nun auch mit :ref:`obj_save` gespeicherte Binärdateien geladen
       werden.

       Der Parameter *bString* braucht nicht mehr angegeben werden.
   * - 5.10.0
     - Neuer Parameter *bString*.
   * - 4.1.0
     - Neu.

.. seealso::
   :ref:`uberblick-uniscript-objekte`,
   :ref:`obj_save`,
   :ref:`error_create`

:sub:`id-213018`