Шаг, направляемый осью поиска

Шаг, направляемый осью поиска, состоит из трех частей: оси поиска (axis), теста узла (node test) и необязательного предиката (predicate). Ось отделяется от теста узла двумя двоеточиями, а предикат записывается после теста узла в квадратных скобках:

ось: тест узла [предикат].

Например, шаг поиска может выглядеть так:

child::section[l]

В этом примере ось поиска child показывает, что поиск охватывает все узлы, непосредственно вложенные в просматриваемый узел, за исключением узлов-атрибутов и узлов пространств имен, тест узла section выбирает из этих узлов узлы-элементы section, а предикат l выбирает первый из встреченных узлов-элементов section.

Каждая из трех частей шага поиска сужает первоначальную область поиска.

Ось поиска задает направление поиска, отсчитываемое от текущего узла, и его объем. Например, поиск может идти в сторону вложенных элементов или, наоборот, просматривать родительские узлы. Можно просматривать только атрибуты элементов или только соседние элементы.

Тест узла выбирает в области поиска, заданной осью, определенные узлы по их имени или типу.

Предикат содержит условия, по которым проверяет узлы, уже отобранные осью поиска и тестом узла, и делает окончательный выбор.

Итак, ось поиска говорит о том, КУДА да мы двигаемся, тест узла показывает, ЧТО мы ищем, а предикат уточняет, КАКИМИ свойствами должен обладать искомый объект.

Познакомимся подробнее с каждой из трех частей шага поиска, определяемого осью.

Оси поиска

В дереве документа естественно выделяются два противоположных направления поиска: "вниз" — от текущего узла документа по ветвям к вложенным узлам-элементам и листьям, и "вверх" — от листьев или текущих узлов-элементов к узлу документа. Оси поиска позволяют организовать поиск и в других направлениях: среди всех потомков данного узла или только среди непосредственных потомков, среди атрибутов, соседних узлов, всех предков данного узла. Всего насчитывается тринадцать осей поиска.

Восемь осей, перечисленных далее, задают прямой поиск (forward axis) — поиск "вниз":

• 
  self — сам текущий узел;
  
• 
  child- все непосредственные узлы-потомки, кроме узлов-атрибутов и узлов пространств имен; эта ось принимается осью по умолчанию;
  
• 
  descendant — все узлы-потомки с их потомками и т. д., не включая узлы атрибуты и узлы пространств имен — рекурсивное применение оси child;
  
• 
  descendant-or-self — сам узел и все его потомки кроме узлов-атрибутов и узлов пространств имен — объединение осей self и descendant;
  
• 
  following— все узлы, лежащие "ниже" текущего узла без узлов-потомков, узлов-атрибутов и узлов пространств имен;
  
• 
  following-sibling — узлы с тем же непосредственным предком, что и у текущего узла, следующие за текущим узлом в том порядке, в котором они записаны в документе; если текущий узел является узлом-атрибутом или узлом пространств имен, то ось пуста;
  
• 
  attribute — узлы-атрибуты текущего узла-элемента; для других видов узлов эта ось пуста;
  
• 
  namespace — узлы пространств имен текущего узла-элемента; для других видов узлов эта ось пуста.
  

• 
  parent — непосредственный предок текущего узла; если его нет, то ось пуста;
  
• 
  ancestor — все узлы-предки текущего узла;
  
• 
  ancestor -or-self — текущий узел вместе со всеми своими предками — объединение осей parent и ancestor;
  
• 
  preceding — узлы, предшествующие текущему узлу в документе XML; не содержит предков текущего узла, узлов-атрибутов и узлов пространств имен;
  
• 
  preceding-sibling — узлы с тем же непосредственным предком, что и у текущего узла, следующие перед текущим узлом в том порядке, в котором они записаны в документе; если текущий узел является узлом-атрибутом или узлом пространств имен, то ось пуста.
  

В шаге поиска, определяемом осью, сама ось может отсутствовать, при этом (за одним исключением) по умолчанию подразумевается ось child.

Поэтому предыдущий пример можно записать проще:

section[1]

Оговоренное исключение касается поиска атрибутов. Если шаг поиска отыскивает атрибуты, то по умолчанию подразумевается ось attribute, например, запись

//attribute(@name)

Эквивалентная запись

//attribute:: attribute(@name)

//@attribute(@name)