DomNode->insert_before

Inserts new node as child ()
domelement DomNode->insert_before ( domelement newnode, domelement refnode )

This function inserts the new node newnode right before the node refnode. The return value is the inserted node. If you plan to do further modifications on the appended child you must use the returned node.

(PHP >= 4.3 only) If newnode already is part of a document, it will be first unlinked from its existing context. If refnode is NULL, then newnode will be inserted at the end of the list of children.

domnode_insert_before() is very similar to domnode_append_child() as the following example shows which does the same as the example at domnode_append_child().

Example 568. Adding a child

copy to clipboard

<?php
include("example.inc");


if (!$dom = domxml_open_mem($xmlstr)) {

  echo "Error while parsing the document\n";

  exit;

}

$elements = $dom->get_elements_by_tagname("informaltable");
print_r($elements);
$element = $elements[0];

$newnode = $element->insert_before($element, $element);
$children = $newnode->children();
$attr = $children[1]->set_attribute("align", "left");


echo "<pre>";
$xmlfile = $dom->dump_mem();

echo htmlentities($xmlfile);

echo "</pre>";
?>

See also domnode_append_child().

Examples ( Source code ) » DomNode->insert_before


<?

sample.xml

<root>

 <parent>

   <child><name>Bob</name></child>

   <child><name>Sue</name></child>

 </parent>

</root>

$dom = new DomDocument();

$dom->load("sample.xml");

$parent_path = "/root";

$query = "//child[position() = 2]";

$query2 = "//child[position() = 1]";

$xpath = new DomXPath($dom);

$parent = $xpath->query($parent_path);

$under = $xpath->query($query);

$above = $xpath->query($query2);

$parent->item(0)->insertBefore($under->item(0), $above->item(0));

$dom->save("sample.xml");

Should produce:

<root>

 <parent>

   <child><name>Sue</name></child>

   <child><name>Bob</name></child>

 </parent>

</root> 



?>

Code Examples / Notes » domnode_insert_before

In a numbered ordering of the document's nodes, insertBefore() will place newNode at the index held by refNode, and increment refNode's index and all subsequent nodes' indices. This is instead of maintaining refNode's index, placing newNode at refNode's position minus one, and shifting all previous nodes' indices down by one. The base case of refNode.index = 0 demonstrates why this must be the case, but it is good to know this explicitly, as it affects methods that deal with iteration such as getElementsByTagName().

DomNode->insert_before

Inserts new node as child () domelement DomNode->insert_before ( domelement newnode, domelement refnode )

Example 568. Adding a child

Code Examples / Notes » domnode_insert_before

Change Language

Inserts new node as child ()
domelement DomNode->insert_before ( domelement newnode, domelement refnode )