DOMXPath->query()

(No version information available, might be only in CVS)

DOMXPath->query() — Evalue l'expression XPath donnée

Description

class DOMXPath {
DOMNodeList query ( string $expression [, DOMNode $contextnode] )
}

Evalue l'expression expression XPath donnée

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 relative. Par défaut, les requêtes sont relatives à l'élément racine.

Valeurs de retour

Retourne un DOMNodeList contenant tous les noeuds correspondant à l'expression expression XPath donnée. Toutes les expressions qui ne retournent pas de noeud retourneront un DOMNodeList vide.

Exemples

Exemple 689. Récupération de tous les livres anglais

<?php

$doc 
= new  DOMDocument ;

// Nous ne voulons pas nous soucier des espaces blancs
$doc -> preserveWhiteSpace  false ;

$doc -> load ( 'book.xml' );

$xpath  = new  DOMXPath ( $doc );

// Nous commençons à l'élément racine
$query  '//book/chapter/para/informaltable/tgroup/tbody/row/entry[. = "en"]' ;

$entries  $xpath -> query ( $query );

foreach (
$entries  as  $entry ) {
    echo 
"Livre trouvé : {$entry->previousSibling->previousSibling->nodeValue},"  .
         
" par {$entry->previousSibling->nodeValue}\n" ;
}
?>

L'exemple ci-dessus va afficher :


Livre trouvé : The Grapes of Wrath, par John Steinbeck
Livre trouvé : The Pearl, par John Steinbeck

    

Nous pouvons également utiliser le paramètre contextnode pour raccourcir notre expression :

<?php

$doc 
= new  DOMDocument ;
$doc -> preserveWhiteSpace  false ;

$doc -> Load ( 'book.xml' );

$xpath  = new  DOMXPath ( $doc );

$tbody  $doc -> getElementsByTagName ( 'tbody' )-> item ( 0 );

// notre requête est relative au noeud tbody
$query  'row/entry[. = "en"]' ;

$entries  $xpath -> query ( $query $tbody );

foreach (
$entries  as  $entry ) {
    echo 
"Livre trouvé : {$entry->previousSibling->previousSibling->nodeValue},"  .
         
" par {$entry->previousSibling->nodeValue}\n" ;
}
?>

Voir aussi

DOMXPath->evaluate()