Памятка XPath

Собрал на одну страницу YS, 22.08.2006

Содержание:

Последовательный туториал
Функции обработки набора узлов
Функции обработки строк
Функции обработки булевых значений
Функции обработки чисел

Последовательный туториал

Источник

Если путь начинается с символа '/', то он представляет абсолютный путь к заданному элементу.
Если путь начинается с //, то будут выбраны все элементы документа, которые соответствуют указанному шаблону.
Символ '*' указывает, что надо выбрать все элементы, соответствующие пути перед ней.
Выражение в квадратных скобках позволяет задавать более четкие критерии для элемента. Так число в квадратных скобках обозначает позицию элемента в выбранном множестве. Функция last() позволяет указать последний элемент в выборке.

/AAA/BBB[1] - Будет выбран первый потомок BBB элемента AAA

/AAA/BBB[last()] - Будет выбран последний потомок BBB элемента AAA

Атрибуты определяются префиксом @.

//@id - Выбираются все атрибуты @id

//BBB[@id] - Выбираются элементы BBB, имеющие атрибут id

//BBB[@*] - Выбираются элементы BBB, имеющие хоть какой-нибудь атрибут

//BBB[not(@*)] - Выбираются элементы BBB, не имеющие ни одного атрибута

Значения атрибутов могут служить критерием при выборке. Функция normalize-space() удаляет пробелы в начале и конце параметра, а все последовательности пробельных символов заменяет одиночным пробелом.

//BBB[@id='b1'] - Выбираются элементы BBB, имеющие атрибут id со значением b1

//BBB[normalize-space(@name)='bbb'] - Выбираются элементы BBB, имеющие атрибут name со значением, которое после нормализации будет идентично bbb

Функция count() возвращает число элементов в указанном множестве.

//*[count(BBB)=2] - Выбираются элементы, имеющие два дочерних элемента BBB

//*[count(*)=2] - Выбираются элементы, имеющие два произвольных дочерних элемента

Функция name() возвращает имя элемента. Функция starts-with() возвращает истину, если строка первого аргумента начинается строкой второго аргумента. Функция contains() возвращает истину, если строка из первого аргумента содержит строку из второго.

//*[name()='BBB'] - Выбираются все элементы с именем BBB; эквивалентно пути //BBB

//*[starts-with(name(),'B')] - Выбираются все элементы, имя которых начинается с B

//*[contains(name(),'C')] - Выбираются все элементы, имя которых содержит C

Функция string-length() возвращает число символов в строке. Следует использовать < вместо <, так как символ '<' зарезервирован для нужд разметки.

//*[string-length(name()) = 3] - Выбираются все элементы, имя которых состоит из трех символов

//*[string-length(name()) < 3] - Выбираются все элементы, имя которых состоит из двух или одного символа

Несколько путей можно скомбинировать с помощью разделителя |.

//CCC | //BBB - Выбираются все элементы CCC и BBB

/AAA/EEE | //BBB - Выбираются все элементы BBB и все элементы EEE, чьим прямым родителем является корневой элемент AAA

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

/child::AAA - Эквивалентно выражению /AAA

Ось descendant содержит потомков контекстного узла; потомком является дочерний элемент, дочерний элемент дочернего элемента и так далее; таким образом ось descendant не содержит узлов атрибутов и пространств имен.

/descendant::* - Выбираются все потомки корневого узла, то есть все элементы

/AAA/BBB/descendant::* - Выбираются все потомки элементов, соответствующих пути /AAA/BBB

//CCC/descendant::* - Выбираются все элементы, имеющие в качестве предка элемент CCC

Ось parent содержит родителя контекстного узла, если он существует.

//DDD/parent::* - Выбираются все родители элемента DDD

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

/AAA/BBB/DDD/CCC/EEE/ancestor::* - Выбираются все узлы, перечисленные в этом абсолютном пути

//FFF/ancestor::* - Выбираются все предки элемента FFF

Ось following-sibling содержит все следующих братьев контекстного узла. Братьями называются те узлы, что имеют одного родителя с контекстным.

/AAA/BBB/following-sibling::*

//CCC/following-sibling::*

пример с источника

Ось preceding-sibling содержит всех предыдущих братьев контекстного узла.

/AAA/XXX/preceding-sibling::*

//CCC/preceding-sibling::*

пример с источника

Ось following содержит в том же порядке, что и в самом документе, все узлы, идущие после контекстного, за исключением всех потомков, узлов атрибутов и пространств имен.

/AAA/XXX/following::*

//ZZZ/following::*

пример с источника

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

/AAA/XXX/preceding::*

//GGG/preceding::*

пример с источника

Ось descendant-or-self содержит контекстный узел и всех его потомков.

/AAA/XXX/descendant-or-self::*

//CCC/descendant-or-self::*

пример с источника

Ось ancestor-or-self содержит контекстный узел и всех его предков; таким образом, эта ось всегда содержит корневой узел.

/AAA/XXX/DDD/EEE/ancestor-or-self::*

//GGG/ancestor-or-self::*

пример с источника

Оси ancestor, descendant, following, preceding и self axes покрывают документ (за исключением узлов атрибутов и пространств имен): они не перескаются и вместе содержат все узлы документа.

//GGG/ancestor::*

//GGG/descendant::*

//GGG/following::*

//GGG/preceding::*

//GGG/self::*

//GGG/ancestor::* | //GGG/descendant::* | //GGG/following::* | //GGG/preceding::* | //GGG/self::*

пример с источника

Оператор div производит деление, оператор mod возвращает остаток от деления нацело. Функция floor возвращает максимальное целое чило, не большее аргумента. Функция ceiling возвращает минимальное целое число, не меньшее аргумента.

//BBB[position() mod 2 = 0 ]

//BBB[ position() = floor(last() div 2 + 0.5) or position() = ceiling(last() div 2 + 0.5) ]

//CCC[ position() = floor(last() div 2 + 0.5) or position() = ceiling(last() div 2 + 0.5) ]

пример с источника

Функции обработки набора узлов

Источник

number last()

Функция last возвращает число, равное размеру контекста обрабатываемого выражения.

number position()

Функция position возвращает число, равное положению в контексте обрабатываемого выражения.

number count(node-set)

Функция count возвращает количество узлов в наборе, представленном в качестве аргумента.

node-set id(object)

Функция id находит элементы по их уникальному идентификатору. Если аргументом функции id является набор узлов, то ее результатом будет объединение узлов, полученных в результате вызова функции id для строкового значения каждого узла в наборе, указанном в качестве аргумента. Если аргумент функции id относится к какому-либо другому типу, то этот аргумент сперва преобразуется в строку как при вызове функции string. Затем полученная строка разбивается на лексемы, разделенные пробельными символами (пробельный символ - это любая последовательность символов, соответствующих сценарию S). Результатом вызова функции в этом случае является набор узлов, состоящий из элементов, относящихся к тому же документу, где находился узел контекста, и имеющих уникальный идентификатор, равный одной из лексем, представленных в этом списке.

id("foo") находит элемент с уникальным идентификатором foo

id("foo")/child::para[position()=5] среди непосредственных потомков элемента с уникальным идентификатором foo находит пятый элемент para

string local-name(node-set?)

Среди набора узлов, указанного в аргументе, функция local-name находит тот узел, который в документе встретится первым, и выделяет локальную часть его расширенного имени. Если в аргументе функции представлен пустой набор узлов или первый обнаруженный узел не имеет расширенного имени, возвращается пустая строка. Если аргумент функции отсутствует, то по умолчанию используется набор, состоящий из единственного члена - узла контекста.

string namespace-uri(node-set?)

В наборе, указанном в аргументе, функция namespace-uri находит тот узел, который в документе встретится первым, и в его расширенном имени выделяет URI пространства имен. Если указанный в аргументе набор узлов пуст, первый найденный узел не имеет расширенного имени, или же URI пространства имен в расширенном имени оказался нулевым, то функция возвращает пустую строку. Если аргумент отсутствует, то по умолчанию берется набор, в котором узел контекста является единственным членом.

Замечание: Для узлов, которые не соответствуют ни элементам, ни атрибутам, функция namespace-uri возвращает пустую строку.

string name(node-set?)

В наборе, указанном в аргументе, функция name находит узел, который в документе встретится первым, и возвращает строку, содержащую QName, которое представляет расширенное имя данного узла. Указанная конструкция QName должна представлять расширенное имя, исходя из деклараций пространств имен, доступная для того узла, чье расширенное имя должно быть представлено. Как правило, это тот самый QName, который был представлен в исходном документе XML. Однако это не обязательно должно быть так в случае, когда декларации, воздействующие на данный узел, с одним и тем же пространством имен связывают несколько префиксов. Тем не менее, реализация может содержать сведения о первоначальном префиксе представляемых узлов, в таком случае может выполняться проверка с тем, чтобы возвращаемая строка была всегда такой же, как QName, используемый в исходном документе XML. Если указанный в аргументе набор узлов пуст или первый узел не имеет расширенного имени, возвращается пустая строка. Если аргумент опущен, то по умолчанию используется набор, содержащий только узел контекста.

Замечание: Для узлов, не являющихся ни элементом, ни атрибутом, строка, возвращаемая функцией name, будет той же самой, что и строка, возвращаемая функцией local-name.

Функции обработки строк

Источник

string string(object?)

Функция string преобразует объект в строку следующим образом:

Набор узлов преобразуется в строку, соответствующую строковому значению того узла в этом наборе, который первым встретится в документе. Если представленный набор узлов пуст, возвращается пустая строка.
Число преобразуется в строку следующим образом

NaN преобразуется в строку NaN
положительный нуль преобразуется в строку 0
отрицательный нуль преобразуется в строку 0
положительная бесконечность преобразуется в строку Infinity
отрицательная бесконечность преобразуется в строку -Infinity
Если число целое, то оно представляется в десятичной форме Number без десятичной точки и ведущих нулей. Если число отрицательное, то его представлению предшествует знак минус (-).
В противном случае число представляется в десятичной форме Number, включающей десятичную точку, по крайней мере одну цифру до десятичной точки и, по крайней мере, одну после. Если число отрицательное, то его представлению предшествует знак минус (-). Десятичной точке не должны предшествовать ведущие нули, за исключением одной обязательной цифры перед десятичной точкой. После десятичной точки должна следовать хотя бы одна цифра, вообще же количество цифр после точки должно быть ровно таким, сколько необходимо, чтобы отличить это число от других чисел в формате IEEE 754, но не большим.

Булево значение false преобразуется в строку false. Булево значение true преобразуется в строку true.
Способ преобразования в строку объекта, не относящегося к четырем основным типам, зависит от этого типа.

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

Замечание: Функция string не предназначена для преобразования чисел в строки для показа пользователю. Для этой цели предназначены функция format-number и элемент xsl:number из [XSLT].

string concat(string, string, string*)

Функция concat возвращает объединение представленных аргументов.

boolean starts-with(string, string)

Функция starts-with возвращает true если строка второго аргумента совпадает с началом строки первого аргумента. В противном случае функция возвращает false.

boolean contains(string, string)

Функция contains возвращает true если строка второго аргумента является частью строки первого аргумента. В противном случае функция возвращает false.

string substring-before(string, string)

Функция substring-before возвращает ту часть строки первого аргумента, которая предшествует первому появлению строки второго аргумента. Если строка второго аргумента не содержится в строке первого аргумента, то функция возвращает пустую строку. Например, substring-before("1999/04/01","/") возвратит 1999.

string substring-after(string, string)

Функция substring-after возвращает ту часть строки первого аргумента, которая следует за первым появлением строки второго аргумента. Если строка второго аргумента не содержится в строке первого аргумента, функция возвращает пустую строку. Например, substring-after("1999/04/01","/") возвращает 04/01, а substring-after("1999/04/01","19") возвращает 99/04/01.

string substring(string, number, number?)

Функция substring возвращает ту часть строки первого аргумента, которая начинается с позиции, указанной вторым аргументом, и имеет длину, указанную в третьем аргументе. Например, substring("12345",2,3) возвращает "234". Если третий аргумент не был представлен, функция возвращает подстроку, начинающуюся с позиции, указанной во втором аргументе, и продолжащуюся до конца строки. Например, substring("12345",2) возвращает "2345".

Точнее выражаясь, каждый символ в строке имеет номер позиции: позиция первого символа - 1, второго символа - 2 и т.д.

Замечание: Такой порядок отличается от принятого в Java и ECMAScript, где метод String.substring считает позицию первого символа нулевой.

Возвращаемая подстрока содержит те символы, позиция которых больше или равна округленному значению второго аргумента, а также, если был указан третий аргумент, меньше чем сумма округленных значений второго и третьего аргументов. Использовавшиеся выше операции сравнения и сложения отвечают правилам стандарта IEEE 754, округление осуществляется как при вызове функции round. Приведенные далее примеры иллюстрируют различные нестандартные ситуации:

substring("12345", 1.5, 2.6) возвращает "234"
substring("12345", 0, 3) возвращает "12"
substring("12345", 0 div 0, 3) возвращает ""
substring("12345", 1, 0 div 0) возвращает ""
substring("12345", -42, 1 div 0) возвращает "12345"
substring("12345", -1 div 0, 1 div 0) возвращает ""

number string-length(string?)

Функция string-length возвращает число символов в строке. Если аргумент опущен, то по умолчанию берется узел контекста и преобразуется в строку, иными словами, берется строковое значение текущего узла контекста.

string normalize-space(string?)

Функция normalize-space возвращает строку аргумента с нормализацией пробельных символов. Сюда входит удаление начальных и завершающих пробельных символов, а также замена оставшихся последовательностей пробельных символов одиночными пробелами. Пробельными считаются символы, являющиеся таковыми согласно сценарию S в языке XML. Если аргумент опущен, то по умолчанию в строку преобразуется узел контекста, иными словами, в качестве аргумента берется строковое значение текущего узла контекста.

string translate(string, string, string)

Функция translate возвращает строку первого аргумента, в которой символы, указанные в строке второго аргумента, заменены символами строки третьего аргумента в соответствующей позиции. Например, translate("bar","abc","ABC") возвращает строку BAr. Если в строке второго аргумента имеется символ, для которого нет парного символа в соответствующей позиции третьей строки (поскольку строка второго аргумента длиннее строки третьего аргумента), то все экземпляры этого символа изымаются из первой строки. Например, translate("--aaa--","abc-","ABC") возвращает "AAA". Если какой-либо символ встретился во второй строке несколько раз, то правило замены определяется первым встреченным экземпляром. Если строка третьего аргумента длиннее, чем строка второго, лишние символы игнорируются.

Замена: Функция translate не может обеспечить преобразование регистра для всех языков. Для преобразования регистра в будущих версии XPath могут появиться дополнительные функции.

Функции обработки булевых значений

Источник

boolean boolean(object)

Функция boolean преобразует аргумент в булево значение следующим образом:

число преобразуется в true тогда и только тогда, когда оно не является ни NaN, ни положительным или отрицательным нулем
набор узлов преобразуется в true тогда и только тогда, когда он непустой
строка преобразуется true тогда и только тогда, когда она имеет ненулевую длину
процедура преобразования в булево значение объекта, не относящегося в четырем основным типам, зависит от типа этого объекта

boolean not(boolean)

Функция not возвращает true тогда и только тогда, когда ее аргументом является false, и false в противном случае.

boolean true()

Функция true возвращает true.

boolean false()

Функция false возвращает false.

Функция: boolean lang(string)

Функция lang возвращает true или false в зависимости от того, является ли язык узла контекста, указываемый в атрибутах xml:lang, тем же самым языком (или подмножеством языка), что указан в строке атрибута. Язык узла контекста задается значением атрибута xml:lang, указанного в этом узле, либо, если сам узел контекста не имеет атрибута xml:lang, то значением атрибута xml:lang у его ближайшего предка, имеющего такой атрибут. Если требуемый атрибут не найден, функция lang возвращает false. Если же атрибут найден, то функция lang возвращает true когда значение этого атрибута равно значению аргумента. При этом регистр игнорируется. Кроме того, если значение атрибута имеет суффикс, начинающийся с дефиса (-), то перед сравнением такой суффикс может быть отброшен. Например, вызов функции lang("en") возвращает true если узлом контекста является любой из пяти указанных элементов:

Функции обработки чисел

Источник