DOMDocument::getElementsByTagNameNS

Searches for all elements with given tag name in specified namespace

&reftitle.description; public `DOMNodeList` `DOMDocument::getElementsByTagNameNS` ``string``null```namespace` `string` `localName`

Returns a `DOMNodeList` of all elements with a given local name and a namespace URI.

&reftitle.parameters;

`namespace`

- The namespace URI of the elements to match on. The special value `"*"` matches all namespaces. Passing &null; matches the empty namespace.

`localName`

- The local name of the elements to match on. The special value `"*"` matches all local names.

&reftitle.returnvalues;

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

&reftitle.changelog;

&Version; | &Description;
8.0.3 | `namespace` is nullable now.

&reftitle.examples;

### Get all the XInclude elements

    <?php

    $xml = <<<EOD
    <?xml version="1.0" ?>
    <chapter xmlns:xi="http://www.w3.org/2001/XInclude">
    <title>Books of the other guy..</title>
    <para>
     <xi:include href="book.xml">
      <xi:fallback>
       <error>xinclude: book.xml not found</error>
      </xi:fallback>
     </xi:include>
     <include>
      This is another namespace
     </include>
    </para>
    </chapter>
    EOD;
    $dom = new DOMDocument;

    // load the XML string defined above
    $dom->loadXML($xml);

    foreach ($dom->getElementsByTagNameNS('http://www.w3.org/2001/XInclude', '*') as $element) {
        echo 'local name: ', $element->localName, ', prefix: ', $element->prefix, "\n";
    }
    ?>

&example.outputs;

    local name: include, prefix: xi
    local name: fallback, prefix: xi

&reftitle.seealso;

- `DOMDocument::getElementsByTagName`