.. highlightlang:: us

.. index:: xml_parse_string

.. _xml_parse_string:

xml_parse_string
================

.. us.tag xml_parse_string GERMAN XML New5200

:ref:`xml_parse_string` wandelt einen gültigen XML-String in ein UniScript-Objekt
um.

.. function:: o = xml_parse_string(ssXML)
    o = xml_parse_string(ssXML, nOptions)

.. us.return

**Returnwert**

*o* ist der XML-Tree oder ein Error-Objekt (siehe :ref:`error_create`). *o* 
enthält die beiden Keys *name* und optional *attr* der ein Objekt enthält.
Die child-Elemente befinden sich in Nummern-Keys beginnend mit 1.

::

	xml_parse_string("<a/>")
	[.
		name = "a"
	]

	xml_parse_string("<a att='1'/>")
	[.
		attr = [.
			att = "1"
		]
		name = "a"
	]

	xml_parse_string("<a att='1'>mixed<b>contents</b></a>")
	[.
		[1] = "mixed"
		[2] = [.
			[1] = "contents"
			name = "b"
		]
		attr = [.
			att = "1"
		]
		name = "a"
	]

.. us.params

**Parameter**

.. uparam:: ssXML

   *ssXML* ist ein gültiger XML-String. 

.. uparam:: nOptions

   *nOptions* ist eine Kombination der folgenden Werte:

   .. list-table::
      :header-rows: 0

      * - NO_SKIP_WHITESPACE (1)
        - Text-Elemente, die nur Leerzeichen, Zeilentrenner und Tabulatorzeichen
          (white space) enthalten, sollen **nicht** ignoriert werden.
      * - NO_SHORT_ATTR (2)
        - Informationen über Reihenfolgen von Attributen speichern.

.. us.comment

**Kommentar**

XML-Deklarationen am Anfang des Strings werden ignoriert.

.. highlight:: xml

::

   <?xml version="1.0" encoding="UTF-8" ?>

Der Eingabestring *ssXML* muss gültige UNICODE-Zeichen enthalten. 
:ref:`text_file_read` liefert für ANSI- und utf-8 kodierte Textdateien
UNICODE-Strings.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.20
     - Neu.

.. seealso::
   :ref:`uberblick-XML`,
   :ref:`text_file_read`,
   :ref:`xml_save_node`,
   :ref:`xml_simple`

:sub:`id-111701`