# DOMDocument::getElementsByTagName

(PHP 5, PHP 7, PHP 8)

DOMDocument::getElementsByTagName — Busca todos los elementos con el nombre de etiqueta local dado

### Descripción

public DOMDocument::getElementsByTagName(string `$qualifiedName`): DOMNodeList

Esta función devuelve una nueva instancia de la clase DOMNodeList que contiene los elementos con el nombre de etiqueta local buscado.

### Parámetros

`qualifiedName`

  El nombre local (sin namespace) de la etiqueta con el cual se hará comparación. El valor especial `*` coincindirá con todas las etiquetas.

### Valores devueltos

Un nuevo objeto DOMNodeList que contiene todos los elementos coincidentes.

### Ejemplos

Ejemplo #1 Ejemplo de uso básico

`<?php
$xml = <<< XML
<?xml version="1.0" encoding="utf-8"?>
<books>
<book>Patrones de Arquitectura de Aplicaciones Empresariales</book>
<book>Patrones de diseño: elementos de diseño de software reutilizable</book>
<book>Código limpio</book>
</books>
XML;
$dom = new DOMDocument;
$dom->loadXML($xml);
$books = $dom->getElementsByTagName('book');
foreach ($books as $book) {
echo $book->nodeValue, PHP_EOL;
}
?>`

El resultado del ejemplo sería:

    Patrones de Arquitectura de Aplicaciones Empresariales
    Patrones de diseño: elementos de diseño de software reutilizable
    Código limpio

### Ver también

- DOMDocument::getElementsByTagNameNS() - Busca todos los elementos con el nombre de etiqueta dado en el espacio de nombre especificado.