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

• 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,collation)

Если 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 и имеющую указанную длину len. Первый символ имеет индекс 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'

Преобразовать строковый параметр в верхний регистр.

Пример: 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

Возвращает подстроку перед出现的 string2 в string1.

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

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

Возвращает подстроку,出现的 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().

Возвращает true, если булево значение false,否则 возвращает 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

Если параметр timezone пуст, то возвращается dateTime без временной зоны.

В противном случае возвращается dateTime с временной зоной.

Если параметр timezone пуст, то возвращается дата без временной зоны.

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

Если параметр timezone пуст, то возвращается время без времениzones.

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

• 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, при этом удаляя элемент, указанный параметром position.

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

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

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

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

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

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

Возвращает 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