Функции XPath, XQuery и XSLT

• fn:base-uri()
• fn:base-uri(node)

• fn:error()
• fn:error(error)
• fn:error(error,description)
• fn:error(error,description,error-object)

пример: error(fn:QName('http://example.com/test', 'err:toohigh'), 'Error: Price is too high')

результат: возвращает во внешнюю обработку http://example.com/test#toohigh и строку "Error: Price is too high".

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

пример: number('100')

результат: 100

возвращает абсолютное значение параметра.

пример: abs(3.14)

результат: 3.14

пример: abs(-3.14)

результат: 3.14

возвращает наименьшую целое число, большее, чем параметр num.

пример:ceiling(3.14)

Результат: 4

Возврат наибольшего целого числа, не превышающего параметр num.

Пример: floor(3.14)

Результат: 3

Округление параметра num до ближайшего целого числа.

Пример: round(3.14)

Результат: 3

Пример: round-half-to-even(0.5)

Результат: 0

Пример: round-half-to-even(1.5)

Результат: 2

Пример: round-half-to-even(2.5)

Результат: 2

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

Пример: string(314)

Результат: "314"

В зависимости от последовательности кодовых точек возвращается строка.

Пример: codepoints-to-string(84, 104, 233, 114, 232, 115, 101)

Результат: 'Thérèse'

В зависимости от строки возвращается последовательность кодовых точек.

Пример: string-to-codepoints("Thérèse")

Результат: 84, 104, 233, 114, 232, 115, 101

• fn:compare(comp1,comp2)
• fn:compare(comp1,comp2,сравнение)

Если comp1 меньше comp2, то возвращается -1. Если comp1 равно comp2, то возвращается 0. Если comp1 больше comp2, то возвращается 1. (В зависимости от используемого правила сравнения).

Пример: compare('ghi', 'ghi')

Результат: 0

Возврат объединения строк.

Пример: concat('XPath ','is ','FUN!')

Результат: 'XPath is FUN!'

Использует параметр sep в качестве разделителя для возвращает скомбинированную строку из string параметров.

Пример: string-join(('We', 'are', 'having', 'fun!'), ' ')

Результат: ' We are having fun! '

Пример: string-join(('We', 'are', 'having', 'fun!'))

Результат: 'Wearehavingfun!'

Пример: string-join((), 'sep')

Результат: ''

• fn:substring(string,start,len)
• fn:substring(string,start)

Возвращает подстроку заданной длины, начинающуюся с позиции start. Индекс первого символа - 1. Если параметр len пропущен, возвращает подстроку от позиции start до конца строки.

Пример: substring('Beatles',1,4)

Результат: 'Beat'

Пример: substring('Beatles',2)

Результат: 'eatles'

• fn:string-length(string)
• fn:string-length()

Возвращает длину заданной строки. Если параметр string отсутствует, возвращает длину строки значения текущего узла.

Пример: string-length('Beatles')

Результат: 7

• fn:normalize-space(string)
• fn:normalize-space()

Удаляет пробельные символы в начале и конце заданной строки, а также заменяет все последовательности пробельных символов в середине на один, затем возвращает результат. Если параметр string отсутствует, обрабатывается текущий узел.

Пример: normalize-space(' The　　　XML ')

Результат: 'The XML'

Преобразует параметр string в заглавные буквы.

Пример: upper-case('The XML')

Результат: 'THE XML'

Преобразует параметр string в строчную букву.

Пример: lower-case('The XML')

Результат: 'the xml'

Заменяет string2 в string1 на string3.

Пример: translate('12:30','30','45')

Результат: '12:45'

Пример: translate('12:30','03','54')

Результат: '12:45'

Пример: translate('12:30','0123','abcd')

Результат: 'bc:da'

Пример: escape-uri("http://example.com/test#car", true())

Результат: "http%3A%2F%2Fexample.com%2Ftest#car"

Пример: escape-uri("http://example.com/test#car", false())

Результат: "http://example.com/test#car"

Пример: escape-uri ("http://example.com/~bébé", false())

Результат: "http://example.com/~b%C3%A9b%C3%A9"

Возвращает true, если string1 содержит string2, в противном случае возвращает false.

Пример: contains('XML','XM')

Результат: true

Возвращает true, если string1 начинается с string2, в противном случае возвращает false.

Пример: starts-with('XML','X')

Результат: true

Возвращает true, если string1 заканчивается на string2, в противном случае возвращает false.

Пример: ends-with('XML','X')

результат: false

Возвращает подстроку, заканчивающуюся последним occurrence строки string2 в строке string1.

Пример: substring-before('12/10','/')

Результат: '12'

Возвращает подстроку, начинающуюся с первого occurrence строки string2 в строке string1.

Пример: substring-after('12/10','/')

Результат: '10'

Возвращает true, если параметр string соответствует указанному шаблону, в противном случае возвращает false.

Пример: matches("Merano", "ran")

Результат: true

Заменяет указанный шаблон на параметр replace и возвращает результат.

Пример: replace("Bella Italia", "l", "*")

Результат: 'Be**a Ita*ia'

Пример: replace("Bella Italia", "l", "")

Результат: 'Bea Itaia'

Пример: tokenize("XPath is fun", "\s+")

Результат: ("XPath", "is", "fun")

Сначала параметр还原ится в булево значение с помощью функции boolean(). Если это значение false, то возвращает true, в противном случае возвращает true.

Пример: not(true())

результат: false

Возвращает булево значение true.

Пример: true()

Результат: true

Возвращает булево значение false.

Пример: false()

результат: false

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

Пример: year-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Результат: 2005

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

Пример: month-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Результат: 01

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

Пример: day-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Результат: 10

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

Пример: hours-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Результат: 12

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

Пример: minutes-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Результат: 30

Возвращает десятичное значение секундной части локального значения аргумента.

Пример: seconds-from-dateTime(xs:dateTime("2005-01-10T12:30:00-04:10"))

Результат: 0

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

Пример: year-from-date(xs:date("2005-04-23"))

Результат: 2005

Возвращает целое число, представляющее месяц в локальном значении параметра.

Пример: month-from-date(xs:date("2005-04-23"))

Результат: 4

Возвращает целое число, представляющее день в локальном значении параметра.

Пример: day-from-date(xs:date("2005-04-23"))

Результат: 23

Возвращает целое число, представляющее часы в локальном значении параметра.

Пример: hours-from-time(xs:time("10:22:00"))

Результат: 10

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

Пример: minutes-from-time(xs:time("10:22:00"))

Результат: 22

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

Пример: seconds-from-time(xs:time("10:22:00"))

Результат: 0

• fn:name()
• fn:name(nodeset)

• fn:local-name()
• fn:local-name(nodeset)

• fn:namespace-uri()
• fn:namespace-uri(nodeset)

Возвращает true, если текущий узел соответствует указанному языку.

Пример: Lang("en") is true for <p xml:lang="en">...</p>

Пример: Lang("de") is false for <p xml:lang="en">...</p>

• fn:root()
• fn:root(node)

Возвращает положение элемента в последовательности, равного параметру searchitem.

Пример: index-of ((15, 40, 25, 40, 10), 40)

Результат: (2, 4)

Пример: index-of (("a", "dog", "and", "a", "duck"), "a")

Результат (1, 4)

Пример: index-of ((15, 40, 25, 40, 10), 18)

Результат: ()

Возвращает новую последовательность, сконструированную из параметра item, при этом удаляя элемент по указанной позиции.

Пример: remove(("ab", "cd", "ef"), 0)

Результат: ("ab", "cd", "ef")

Пример: remove(("ab", "cd", "ef"), 1)

Результат: ("cd", "ef")

Пример: remove(("ab", "cd", "ef"), 4)

Результат: ("ab", "cd", "ef")

Если параметр имеет пустой сеquence, возвращает true, в противном случае возвращает false.

Пример: empty(remove(("ab", "cd"), 1))

результат: false

возвращает true, если значение параметра не является пустой последовательностью, в противном случае возвращает false.

пример: exists(remove(("ab"), 1))

результат: false

возвращает уникальные значения.

пример: distinct-values((1, 2, 3, 1, 2))

результат: (1, 2, 3)

возвращает новую последовательность, сконструированную из параметра item, при этом в позиции, указанной параметром pos, вставляется значение параметра inserts.

пример: insert-before(("ab", "cd"), 0, "gh")

результат: ("gh", "ab", "cd")

пример: insert-before(("ab", "cd"), 1, "gh")

результат: ("gh", "ab", "cd")

пример: insert-before(("ab", "cd"), 2, "gh")

результат: ("ab", "gh", "cd")

пример: insert-before(("ab", "cd"), 5, "gh")

результат: ("ab", "cd", "gh")

возвращает указанную последовательность элементов в обратном порядке.

пример: reverse(("ab", "cd", "ef"))

результат: ("ef", "cd", "ab")

пример: reverse(("ab"))

результат: ("ab")

возвращает последовательность элементов, начиная с позиции, указанной параметром start, длина которой задается параметром len. Позиция первого элемента - 1.

пример: subsequence(($item1, $item2, $item3,...), 3)

результат: ($item3, ...)

пример: subsequence(($item1, $item2, $item3, ...), 2, 2)

результат: ($item2, $item3)

Возвращает среднее арифметическое значений параметров

Пример: avg((1,2,3))

Результат: 2

Возвращает параметр, больший других параметров

Пример: max((1,2,3))

Результат: 3

Пример: max(('a', 'k'))

Результат: 'k'

Возвращает параметр, меньший других параметров

Пример: min((1,2,3))

Результат: 1

Пример: min(('a', 'k'))

Результат: 'a'

• fn:collection()
• fn:collection(string)

Вернуть индекс位置的 текущего обрабатываемого узла.

Пример: //book[position()<=3]

Результат: выбрать первые три элемента book

Вернуть количество элементов в списке обработанных узлов.

Пример: //book[last()]

Результат: выбрать последний элемент book