Имя функции определяется синтаксическим правилом FunctionName. Функция может иметь любое корректное с точки зрения XML имя, кроме названий типов узлов (comment, processing-instruction, text и node):
[XP35] FunctionName ::= QName - NodeType
В базовой библиотеке XPath выделяют четыре типа функций: функции для работы с булевыми значениями, с числами, со строками и с множествами узлов.
Булевые функции
Функция boolean
boolean boolean(object)
Функция boolean явным образом преобразует объект, который ей передается в булевый тип в соответствии с правилами, изложенными в главе "Типы данных XPath". Напомним вкратце эти правила.
□ Число преобразуется в "ложь", если оно является положительным или отрицательным нулем или не-числом (NaN). В противном случае число будет преобразовано в "истину".
□ Строка преобразуется в "ложь", если она не содержит символов, то есть, ее длина равна нулю. Непустая строка преобразуется в "истину".
□ Множество узлов преобразуется в "ложь", если оно пусто. Непустое множество узлов преобразуется в "истину".
□ Объекты других типов преобразуются в булевые значения по собственным правилам. Например, результирующий фрагмент дерева всегда преобразуется в "истину".
Примеры:
boolean(2-2) → false
boolean(number('two')) → false
boolean(-1) → true
boolean(1 div 0) → true
boolean(-1 div (1 div 0)) → false
boolean(-1 div (-1 div 0)) → false
boolean(-1 div (-1 div 0) +1) → true
boolean('') → false
boolean('true') → true
boolean('false') → true
boolean(/) → true
Это выражение всегда будет обращаться в true, поскольку у документа всегда есть корневой узел.
boolean(/self::node()) → true
Это выражение также обратится в true, поскольку корневой узел соответствует тесту node().
boolean(/self::text()) → false
Это выражение обратится в false, поскольку корневой узел не является текстовым узлом.
Функция not
boolean not(boolean)
Функция not выполняет логическое отрицание. Если аргументом была "истина", not возвращает "ложь", если аргумент был "ложью", not вернет "истину". Если функции был передан аргумент не булевого типа (например, число), то он сначала будет сконвертирован в тип boolean.
Примеры:
not(false) → true
not(true) → false
not('false') → false
not('true') → false
not(0) → true
not(/) → false
Функции true и false
boolean true()
boolean false()
Две функции true и false возвращают тождественную "истину" и тождественную "ложь" соответственно. В XPath нет констант и, тем более, логических констант, определяющих "истину" и "ложь", как в других языках. Функции true и false восполняют эту нехватку.
Примеры:
true() or $var → true
Это выражение всегда будет истинным вне зависимости от значения переменной var, поскольку дизъюнкция (логическая операция "или") с тождественной "истиной" всегда будет "истиной".
false() and $var → false
Это выражение всегда будет ложным вне зависимости от значения переменной var, поскольку конъюнкция (логическая операция "и") с тождественной "ложью" всегда будет "ложью".
Функция lang
boolean lang(string)
Функция lang может использоваться для того, чтобы определить языковой контекст контекстного узла. В элементах XML можно использовать атрибут lang пространства имен xml для определения языка содержимого узла, например;
<text xmclass="underline" lang="en-gb">
Yet no living human being have been ever blessed with seeing...
</text>
Пространство имен, соответствующее префиксу xml, не требуется объявлять. Это служебное пространство имен, которое неявно задано во всех XML-документах.
Функция lang возвратит "истину", если идентификатор языка, который передан ей в виде строкового параметра, соответствует языковому контексту контекстного узла. Это определяется следующим образом.
□ Если ни один из предков контекстного узла не имеет атрибута xmclass="underline" lang, функция возвращает "ложь".
□ Иначе строковый параметр проверяется на соответствие значению атрибута xmclass="underline" lang ближайшего предка. Если эти значения равны в любом регистре символов, или атрибут начинается как значение параметра функции и имеет суффикс, начинающийся знаком "-", функция возвращает "истину".
□ В противном случае функция возвращает "ложь".
Примеры:
Функция lang('en') возвратит "истину" в контексте любого из следующих элементов:
<body xmclass="underline" lang="EN"/>
<body xmclass="underline" lang="en-GB"/>
<body xmclass="underline" lang="en-us"/>
<body xmclass="underline" lang="EN-US"/>
Функция lang('de') возвратит "истину" в контексте элемента b и "ложь" — в контексте элементов а и с:
<а>
<b xmclass="underline" lang="de">
<c xmclass="underline" lang="en"/>
</b>
</a>
Числовые функции
Функция number
number number(object?)
Функция number явным образом конвертирует свой аргумент в числовой тип. Если аргумент не указан, функции передается множество узлов, состоящее из единственного контекстного узла. Коротко напомним правила преобразования в числовой тип.
□ Значения булевого типа преобразуются в 0 или 1 следующим образом: "ложь" преобразуется в 0, "истина" в 1.
□ Строковое значение преобразуется в число, которое оно представляет.
□ Множество узлов сначала преобразуется в строку, а затем, как строка в число. Фактически численным значением множества узлов является численное значение его первого узла.