DOMXPath::evaluate
Évalue une expression XPath donnée et retourne un résultat typé si possible
&reftitle.description;
public mixedDOMXPath::evaluate
stringexpression
DOMNodenullcontextNode&null;
boolregisterNodeNS&true;
Exécute l'expression XPath expression
et retourne un résultat typé si possible.
&reftitle.parameters;
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.
&reftitle.returnvalues;
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;.
&reftitle.examples;
Récupération du nombre total de livres anglais
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";
?>
]]>
&example.outputs;
&reftitle.seealso;
DOMXPath::query