DOMXPath::query
(PHP 5, PHP 7, PHP 8)
DOMXPath::query — Виконує заданий вираз XPath
Опис
public DOMXPath::query(string $expression, ?DOMNode $contextNode = null, bool $registerNodeNS = true): mixed
Виконує заданий XPath-вираз expression
Список параметрів
expression
Вираз XPath для виконання.
contextNode
Додатковий параметр contextNode може бути вказаний до виконання відносних запитів XPath. За промовчанням запити виконуються щодо кореневого елемента.
registerNodeNS
Чи потрібно автоматично реєструвати префікси простору імен в області видимості контекстного вузла для об'єкта DOMXPath. Параметр допомагає уникати ручного виклику методу DOMXPath::registerNamespace() для кожного простору імен у області видимості. Коли префікси простору імен конфліктують, реєструється лише префікс простору імен найближчого нащадка.
Значення, що повертаються
Повертає об'єкт DOMNodeList, що містить вузли, що відповідають виразу XPath expression. Будь-який вираз, що не повертає вузли, поверне порожній об'єкт DOMNodeList
Якщо expressionпостроено неправильно илиcontextNodeимеет неверное значение,DOMXPath::query() поверне false
Приклади
Приклад #1 Отримання списку всіх книг англійською
Результат виконання наведеного прикладу:
Найдена книга The Grapes of Wrath, автор John Steinbeck
Найдена книга The Pearl, автор John Steinbeck
Можна також використовувати параметр contextNode для більш короткого запису виразу:
Дивіться також
- DOMXPath::evaluate() - Обчислює переданий вираз XPath і повертає типізований результат, якщо можливо