(PHP 5 >= 5.1.0, PHP 7, PHP 8)
DOMXPath::evaluate —
Évalue une expression XPath donnée et retourne un résultat typé si possible
Description
public
DOMXPath::evaluate(string
$expression
, ?DOMNode
$contextNode
=
null
, bool
$registerNodeNS
=
true
): mixed
Liste de paramètres
-
expression
-
L'expression XPath à exécuter.
-
contextNode
-
Le paramètre optionnel contextNode
peut être
spécifié pour effectuer des requêtes XPath relatives. Par défaut, les requêtes
sont relatives à l'élément root.
-
registerNodeNS
-
Le paramètre optionnel registerNodeNS
peut être
renseigné pour désactiver l'enregistrement automatique du nœud de
contexte.
Valeurs de retour
Retourne un résultat typé si possible ou un DOMNodeList
contenant tous les nœuds correspondant à l'expression XPath
expression
.
Si le paramètre expression
est mal formé
ou bien si le paramètre contextNode
est invalide,
la méthode domxpath::evaluate() retournera false
.
Exemples
Exemple #1 Récupération du nombre total de livres anglais
<?php
$doc = new DOMDocument;
$doc->load('book.xml');
$xpath = new DOMXPath($doc);
$tbody = $doc->getElementsByTagName('tbody')->item(0);
// notre requête est relative au nœud tbody
$query = 'count(row/entry[. = "en"])';
$entries = $xpath->evaluate($query, $tbody);
echo "Il y a $entries livres anglais\n";
?>
L'exemple ci-dessus va afficher :
Il y a 2 livres anglais
Voir aussi
- DOMXPath::query() - Évalue l'expression XPath donnée