PHP 5.4.33 Released

DomDocument->get_elements_by_tagname

(PHP 4 >= 4.1.0)

DomDocument->get_elements_by_tagname Returns array with nodes with given tagname in document or empty array, if not found

Description

array DomDocument->get_elements_by_tagname ( string $name )

See also domdocument_add_root()

add a note add a note

User Contributed Notes 6 notes

up
0
jon at hiveminds dot net
10 years ago
Warning to win32 users: It appears that use of the wildcard argument to this function (e.g.

<?php
  $alltags
= $domdoc->get_elements_by_tagname("*");
?>

) to return a collection of all DomElements in a document, which worked in php4.3.0-4.3.3, is broken in php4.3.4 for Windows. Upgrading broke numerous scripts depending on this behaviour, which returned to normal as soon as I rolled back to 4.3.3-win32.

I had intended to offer a workaround using child_nodes(), but found problems with this also. Therefore my suggested workarounds are either (a) don't upgrade to 4.3.4 if you're running this extension on Windows and are depending on the wildcard behaviour or (b) rewrite your code so as to use actual tagnames

The wildcard usage is per the W3C DOM spec, so hopefully this will be fixed and available again in 4.3.5.
up
0
Salman
10 years ago
Yes it does return an object; the object is of type DomElement. Hopefully this code will help:

$element = new DomElement();

if(!$dom = domxml_open_file($xml_file)) {
   die("Error opening xml file");
}

$tables = $dom->get_elements_by_tagname("table");
foreach($tables as $table) {
    $element = $table;
    echo "Attribute name: ", $element->get_attribute("name");
}

- Salman
http://wwww.setcomputing.com/
up
0
blah at pasher dot org
11 years ago
Correction to my last note: DomElement (and DomDocument) have their own get_elements_by_tagname() method. It does not get it from DomNode.
up
0
blah at pasher dot org
11 years ago
To clarify some confusion:

This function returns an integer-indexed array of DomElement objects. The DomElement class extends the DomNode class, so all DomNode methods are available to this new object. Additional notes can be found under the "DomElement->get_elements_by_tagname" manual section. DomElement uses the DomNode method (unless DomElement overrides this method, but I don't think that occurs).

Also note, if there are no nodes matching your criteria, it returns an empty array, not false.
up
0
KingGeoffrey at yahoo dot com
12 years ago
The return looks like an integer indexed array of objects when i try it.

Versions
php:4.2.1 domxml:2.4.9

Code fragment:
    $nodes = $doc->get_elements_by_tagname("user");
    reset($nodes);
    while (list($key, $value) = each($nodes)) {
        echo "$key = " . $value->get_attribute('username') . "<br />\n";

    }

Output fragment:
0 = a
1 = b
2 = c
up
0
scouture at courtweb dot com
12 years ago
Seems that this function return an object instead of an array. I've tried this :

if(!$dom = domxml_open_file("g://program files/apache group/apache/htdocs/intranetcw/data/config_one.xml"))
{
  echo "Error while parsing the document\n";
  exit;
}

//array DomDocument->get_elements_by_tagname ( string name)

$array_element = $dom->get_elements_by_tagname("IP_ORACLE_CONFIG");
if ($array_element)
{
    echo count($array_element)." array count<br>";
    for ($i=0;$i<count($array_element);$i++)
    {
        echo $array_element[$i]." array content<br>";
    }
}
else
{
    echo "you get nothing";
}

and the result was :

1 array count
Object array content

Styve
To Top