CopyXMLNode()

Синтаксис

*Result = CopyXMLNode(*Node , *ParentNode [, *PreviousNode])

Описание

Копирует данный узел XML и всё его содержимое - текст и дочерние узлы в новое место. С помощью этой функции можно копировать узлы даже в другое дерево XML. Чтобы переместить узел целиком на новое место, воспользуйтесь функцией MoveXMLNode().

Параметры

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

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

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

Комментарии

Для успешного копирования должны выполняться следующие правила:
- Корневой узел дерева не может быть скопирован
- ParentNode не может иметь тип #PB_XML_Comment или #PB_XML_CData
- *PreviousNode должен быть прямым потомком узла ParentNode (если параметр задан),
- Если дерево XML уже содержит главный узел, то на корневом уровне можно вставлять только узлы, тип которых не #PB_XML_Normal и #PB_XML_CData.

См. также

DeleteXMLNode(), MoveXMLNode()

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

Все