DOMDocument::getElementsByTagName

Searches for all elements with given local tag name

&reftitle.description; public `DOMNodeList` `DOMDocument::getElementsByTagName` `string` `qualifiedName`

This function returns a new instance of class `DOMNodeList` containing all the elements with a given local tag name.

&reftitle.parameters;

`qualifiedName`

- The local name (without namespace) of the tag to match on. The special value `*` matches all tags.

&reftitle.returnvalues;

A new `DOMNodeList` object containing all the matched elements.

&reftitle.examples;

### Basic Usage Example

    <?php
    $xml = <<< XML
    <?xml version="1.0" encoding="utf-8"?>
    <books>
     <book>Patterns of Enterprise Application Architecture</book>
     <book>Design Patterns: Elements of Reusable Software Design</book>
     <book>Clean Code</book>
    </books>
    XML;

    $dom = new DOMDocument;
    $dom->loadXML($xml);
    $books = $dom->getElementsByTagName('book');
    foreach ($books as $book) {
        echo $book->nodeValue, PHP_EOL;
    }
    ?>

&example.outputs;

    Patterns of Enterprise Application Architecture
    Design Patterns: Elements of Reusable Software Design
    Clean Code

&reftitle.seealso;

- `DOMDocument::getElementsByTagNameNS`