InsertXMLMap()

Синтаксис

Result = InsertXMLMap(*ParentNode , Map() [, *PreviousNode])

Описание

Вставляет указанный Карту() в качестве нового узла XML в данный родительский узел.

Параметры

*ParentNode	Узел, в который будет вставлен новый дочерний узел. Здесь для вставки нового узла в корень дерева можно использовать функцию RootXMLNode().
Map()	Хеш - Карта, которая будет вставлена в качестве узла в XML.
*PreviousNode (дополн.)	Задаёт дочерний узел узла '*ParentNode', после которого должен быть вставлен новый узел. Если это значение равно 0 или не указано, новый узел вставляется как первый дочерний узел своего родителя. Если это значение равно -1, узел вставляется как последний дочерний узел своего родителя.

Возвращаемое значение

Возвращает указатель на новый узел XML, если он был успешно создан, если же узел в это место вставить не удалось, возвратится ноль.

Комментарии

Правила указанные в CreateXMLNode(), которые определяют, где новый узел может быть вставлен, также применяются к этой функции.

Вставленный узел называется "map", а узлы содержащие элементы - "element". У каждого узла элемента будет атрибут с названием "key", содержащим ключ элемента хеш-карты. Ниже приведен пример создания XML.

Пример

; В этом примере создается следующее дерево XML:
;
; <map>
;  <element key="DE">Germany</element>
;  <element key="US">United States</element>
;  <element key="FR">France</element>
; </map>
;
NewMap Countries.s()
Countries("DE") = "Germany"
Countries("FR") = "France"
Countries("US") = "United States"

If CreateXML(0)
    InsertXMLMap(RootXMLNode(0), Countries())
    FormatXML(0, #PB_XML_ReFormat)
    Debug ComposeXML(0)
EndIf

См. также

ExtractXMLMap(), InsertXMLArray(), InsertXMLList(), InsertXMLStructure()

Поддерживаемые OS

Все