DOMXPath::__construct
DOMXPath::query
DOMXPath
PHP Manual

# DOMXPath::evaluate

(PHP 5 >= 5.1.0)

DOMXPath::evaluate — Evaluates the given XPath expression and returns a typed result if possible

### Descrição

public mixed DOMXPath::evaluate ( string `$expression` [, DOMNode `$contextnode` [, bool `$registerNodeNS` = true ]] )

Executes the given XPath `expression` and returns a typed result if possible.

### Parâmetros

`expression`

  The XPath expression to execute.

`contextnode`

  The optional `contextnode` can be specified for doing relative XPath queries. By default, the queries are relative to the root element.

`registerNodeNS`

  The optional `registerNodeNS` can be specified to disable automatic registration of the context node.

### Valor Retornado

Returns a typed result if possible or a DOMNodeList containing all nodes matching the given XPath `expression`.

If the `expression` is malformed or the `contextnode` is invalid, DOMXPath::evaluate() returns `FALSE`.

### Changelog

Versão | Descrição
--- | ---
5.3.3 | The `registerNodeNS` parameter was added.

### Exemplos

Exemplo #1 Getting the count of all the english books

`<?php
$doc = new DOMDocument;
$doc->load('book.xml');
$xpath = new DOMXPath($doc);
$tbody = $doc->getElementsByTagName('tbody')->item(0);
// our query is relative to the tbody node
$query = 'count(row/entry[. = "en"])';
$entries = $xpath->evaluate($query, $tbody);
echo "There are $entries english books\n";
?>`

O exemplo acima irá imprimir:

    There are 2 english books

### Veja Também

- DOMXPath::query() - Evaluates the given XPath expression

DOMXPath::__construct
DOMXPath::query
DOMXPath
PHP Manual