XPath, XQuery и функции XSLT
Ниже справочное руководство определяет функции XPath 2.0, XQuery 1.0 и XSLT 2.0.
Справочное руководство по функциям
Функция префикс пространства имен по умолчанию для Fn:
Функция URI пространства имен является: http://www.w3.org/2005/xpath-functions
функция доступа
имя | объяснение |
---|---|
Имя узла (узел): п | Возвращает узел узла имя параметра. |
п: nilled (узел) | Возвращает ли отвергнуть аргумент узла логическое значение. |
Fn: данные (item.Item, ...) | Примите последовательность проекта и возвращает последовательность атомарных значений. |
| Возвращает значение текущего атрибута базового URI-указывает узел или узлы. |
п: документ-URI (узел) | Возвращает значение указанного узла документа-URI свойства. |
Ошибки и функции отслеживания
имя | объяснение |
---|---|
| Примеры: ошибка (п: QName ( 'http://example.com/test', 'ERR: toohigh'), 'Ошибка: Цена слишком высока ") Результаты: Возвращает http://example.com/test#toohigh~~number=plural и строки к внешней среде обработки "Ошибка: Цена слишком высока". |
п: след (значение, ярлык) | Он используется для запроса отладки. |
Функции , связанные значения
имя | объяснение |
---|---|
п: число (ARG) | Возвращает значение параметра. Параметр представляет собой логическое значение, строка или набор узлов. Примеры: номер ( '100') Результаты: 100 |
п: абс (Num) | Возвращает абсолютное значение параметра. Примеры: абс (3.14) Результаты: 3.14 Примеры: ABS (-3.14) Результаты: 3.14 |
п: потолок (Num) | Возвращает наименьшее целое, которое больше параметра Num. Примеры: потолок (3.14) Результаты: 4 |
п: этаж (NUM) | Возвращает наибольшее целое число не больше параметра Num. Примеры: пол (3.14) Результаты: 3 |
п: круглая (Num) | Num аргумент округляется до ближайшего целого числа. Примеры: круглые (3.14) Результаты: 3 |
п: круглая половина к даже () | Примеры: круглый половина к даже (0.5) Результаты: 0 Примеры: круглый половина к даже (1.5) Результаты: 2 Примеры: круглый половина к даже (2.5) Результаты: 2 |
Функции о строках
имя | объяснение |
---|---|
Fn: строка (ARG) | Возвращает строковое значение параметра. Аргументы могут быть числами, логическими значениями или набор узлов. Примеры: строка (314) Результат: "314" |
Fn: кодовые в строку (INT, INT, ...) | В соответствии с кодовой последовательности точка возвращает строку. Примеры: кодовые в строку (84, 104, 233, 114, 232, 115, 101) Результаты: 'Therese' |
п: Строка-кодовых значений (строка) | Согласно строка обратной последовательности кода точки. Примеры: Строка-кодовых значений ( "Therese") Результат: 84, 104, 233, 114, 232, 115, 101 |
п:-равно элемент кода (comp1, comp2) | Согласно точке сравнения кода Unicode, если значение равно значению COMP1 comp2 Возвращает истину. (Http://www.w3.org/2005/02/xpath-functions/collation/codepoint), в противном случае она возвращает ложь. |
| Если comp1 менее comp2, возвращается -1. Если COMP1 равной comp2, возвращается 0. Если COMP1 больше comp2, 1 возвращается. (В соответствии с правилами, используемыми контролем). Пример: сравнение ( 'GHI', 'ГХИ') Результаты: 0 |
п: CONCAT (строка, строка, ...) | Возвращает конкатенацию. Примеры: CONCAT ( 'XPath', 'есть', 'FUN!') Результаты: 'XPath является FUN! |
п: строка присоединиться ((строка, строка, ...), SEP) | Используйте в качестве сен разделителем аргумента, чтобы вернуть строку параметров строки после того, как шить. Примеры: строка присоединиться ( '! Забаву' ( 'Мы', 'есть', 'имеющий',), '') Результаты: "Мы с удовольствием!" Примеры: строка присоединиться ( '! Забаву' ( 'Мы', 'есть', 'имеющий',)) Результаты: 'Wearehavingfun!' Примеры: строка присоединиться ((), '') Sep Результаты: '' |
| Возвращает подстроку из начального положения в начале указанной длины. Индекс первого символа равен 1. Если опустить аргумент LEN от начальной позиции до конца строки возвращается. Примеры: подстрока ( "Битлз", 1,4) Результаты: 'Beat' Примеры: подстрока ( "Битлз", 2) Результаты: 'eatles' |
| Возвращает длину строки. Если нет аргумент строки, длина строковое значение текущего узла возвращается. Примеры: длины строки ( 'Битлз ") Результаты: 7 |
| Удалите начало и конец указанной строки пустой, пустой и все заменяется серией внутренних и возвращает результат. Если нет аргумент строки, процесс текущего узла. Примеры: нормализуют-пространство ( 'XML-') Результаты: 'XML-' |
Fn: нормализуют-юникода () | Осуществление нормализации Unicode. |
п: верхний регистр (строка) | Аргумент строки в верхний регистр. Примеры: верхний регистр ( 'XML-') Результаты: 'XML-' |
п: нижний регистр (строка) | Аргумент строка преобразуется в нижний регистр. Примеры: нижний регистр ( 'XML-') Результаты: "XML-файл ' |
п: переводить (string1, string2, string3) | String1 в ТАБЛИЦЕ2 заменен string3. Примеры: перевод ('12: 30 ',' 30 ',' 45 ') Результаты: '12: 45 ' Примеры: перевод ('12: 30 ',' 03 ',' 54 ') Результаты: '12: 45 ' Примеры: перевод ('12: 30 ',' 0123 ',' ABCD ') Результаты: 'Ьс: да' |
п: бежать-URI (stringURI, ЭКУ-Res) | Примеры: бежать-URI ( "http://example.com/test#car", правда ()) Результаты: "HTTP% 3A% 2F% 2Fexample.com% 2Ftest # автомобиль" Примеры: бежать-URI ( "http://example.com/test#car", ложная ()) Результаты: "http://example.com/test#car" Примеры: бежать-URI ( "http://example.com/~bebe", ложная ()) Результаты: "http://example.com/~b%C3%A9b%C3%A9" |
п: содержит (string1, string2) | Если string1 содержит string2, он возвращает истину, в противном случае возвращает ложь. Примеры: содержит ( 'XML', 'XM') Результаты: истинные |
Fn: старты-с (string1, string2) | Если string1 начинается с строке2, он возвращает истину, в противном случае возвращает ложь. Примеры: старты-с ( 'XML', 'X') Результаты: истинные |
п: концы-с (string1, string2) | Если string1 с string2 конце возвращает истину, в противном случае она возвращает ложь. Примеры: концы-с ( 'XML', 'X') Результаты: ложные |
Fn: подстрока-раньше (string1, string2) | Возвращает подстроку string1 string2 появляются раньше. Примеры: подстрока-раньше ('12 / 10 ',' / ') Результаты: '12 ' |
Fn: подстрока-после (string1, string2) | Возвращает подстроку string1 string2 появляются позже. Примеры: подстрока-после того, как ('12 / 10 ',' / ') Результаты: '10 ' |
Fn: матчи (строка, шаблон) | Если строка соответствует заданному шаблону, он возвращает истину, в противном случае возвращает ложь. Примеры: матчи ( "Мерано", "побежал") Результаты: истинные |
п: заменить (строка, шаблон, заменить) | Указанный режим заменяется параметром замены и возвращает результат. Примеры: заменить ( "Bella Italia", "л", "*") Результаты: "Be ** в Ita * Ia ' Примеры: заменить ( "Bella Italia", "L", "") Результаты: "Беа Itaia ' |
п: токенизировать (строка, шаблон) | Примеры: токенизировать ( "XPath это весело", "\ s +") Результаты :( "XPath", "есть", "весело") |
Функция AnyURI для
имя | объяснение |
---|---|
п: Решимость-URI (относительное, основание) |
Функции логических значений
имя | объяснение |
---|---|
п: булево (ARG) | Возвращает логическое значение числовой, строка или набор узлов. |
п: не (ARG) | Во-первых, функция булево () для восстановления параметров логического значения. Если логическое значение ложно, то возвращает истину, в противном случае она возвращает истину. Пример: нет (правда ()) Результаты: ложные |
п: верно () | Возвращает логическое значение, верно. Примеры: истина () Результаты: истинные |
п: ложная () | Возвращает логическое значение ЛОЖЬ. Примеры: ложная () Результаты: ложные |
Функции , связанные с длительностью, дата и время
Дата, время, длительность функции извлечения компонентов
имя | объяснение |
---|---|
п: DATETIME (дата, время) | Аргументы даты и времени. |
Fn: лет-из-длительности (datetimedur) | Целая часть года возвращаемого значения стандартного обозначения для представления слов. |
Fn: многомесячная из-длительности (datetimedur) | Возвращает целую часть значений параметров месяца, в стандартных обозначениях для представления слов. |
Fn: дни-от-длительности (datetimedur) | Возвращает целую часть значений параметров в день, в стандартных обозначениях для представления слов. |
Fn: многочасовая из-длительности (datetimedur) | Возвращает целую часть значений параметров час, стандартных обозначений для представления слов. |
Fn: мин-от-длительности (datetimedur) | Возвращает целую часть протокола значений параметров, стандартное обозначение для представления слов. |
Fn: секундных из-длительности (datetimedur) | Возвращает дробную часть числа минут значений параметров, стандартных обозначений для представления слов. |
п: год из-DATETIME (DateTime) | Возвращает значения параметра целое число в локальной секции. Примеры: год из-DATETIME (хз: DATETIME ( "2005-01-10T12: 30-04: 10")) Результаты: 2005 |
п: месяц-из-DATETIME (DateTime) | Возвращает целую часть ежемесячных локальных значений параметров. Примеры: месяц из-DATETIME (хз: DATETIME ( "2005-01-10T12: 30-04: 10")) Результаты: 01 |
п: изо дня из-DATETIME (DateTime) | Возвращает целую часть локальных значений параметров день. Примеры: день из-DATETIME (хз: DATETIME ( "2005-01-10T12: 30-04: 10")) Результаты: 10 |
Fn: многочасовая из-DATETIME (DateTime) | Возвращает целую часть часов параметров локальных значений. Примеры: часы-из-DATETIME (хз: DATETIME ( "2005-01-10T12: 30-04: 10")) Результаты: 12 |
Fn: мин-из-DATETIME (DateTime) | Возвращает целую часть параметров локального значение минуты. Примеры: минуты: от-DATETIME (хз: DATETIME ( "2005-01-10T12: 30-04: 10")) Результаты: 30 |
Fn: секундных из-DATETIME (DateTime) | Возвращает десятичную часть второго локальных значений параметров. Примеры: секунды-из-DATETIME (хз: DATETIME ( "2005-01-10T12: 30: 00-04: 10")) Результаты: 0 |
п: часовой пояс-из-DATETIME (DateTime) | Возвращает часть региона, если она присутствует. |
п: год от современной (дата) | В целочисленных возвращаемых значений, которые представляют локальные параметры. Примеры: год от современных (хз: дата ( "2005-04-23")) Результаты: 2005 |
п: месяц-с-даты (дата) | Целый месяц Возвращает локальное значение параметра, указанного. Примеры: месяц от современных (хз: дата ( "2005-04-23")) Результаты: 4 |
п: изо дня в современной (дата) | День возвращают целое число значение представляет локальный параметр. Примеры: день от современных (хз: дата ( "2005-04-23")) Результаты: 23 |
п: часовой пояс-с-даты (дата) | Возвращает часть региона, если она присутствует. |
Fn: многочасовая от времени (время) | Возвращает целую часть часов, представленные локальные значения параметров. Примеры: часы-от-времени (хз: время ( "10:22:00")) Результаты: 10 |
Fn: мин-от-времени (время) | Возвращает целую часть параметров локальное значение минут представляет. Примеры: минуты: от времени (хз: время ( "10:22:00")) Результаты: 22 |
Fn: секундных от времени (время) | Целая часть второго возвращаемого значения параметр указывает локальный. Примеры: секундных от времени (хз: время ( "10:22:00")) Результаты: 0 |
п: часовой пояс-от-времени (время) | Возвращает часть региона, если она присутствует. |
п: настройка-DATETIME к временной зоны (даты и времени, часовой пояс) | Если часовой пояс аргумент пуст, он не возвращает времени DATETIME зону. В противном случае, она возвращает объект DateTime с часовым поясом. |
п: настройка-дата-на-часовом поясе (дата, часовой пояс) | Если часовой пояс аргумент пуст, он не возвращает времени дата зоны. В противном случае, она возвращает дату с часовым поясом. |
п: настройка-время-часовой пояс (время, часовой пояс) | Если часовой пояс аргумент пуст, он не возвращает часового пояса времени. В противном случае время с часовым поясом. |
И QNames функции , связанные с
имя | объяснение |
---|---|
п: QName () | |
п: имя локальной из-QName () | |
п: пространство имен-Ури из-QName () | |
п: пространство имен-URI-для-приставки () | |
п: в-Scope префиксов () | |
п: Решимость-QName () |
Функция узла
имя | объяснение |
---|---|
| Возвращает имя текущего узла или указать первый узел кластера. |
| Возвращает первый из имени текущего узла или указать узел в кластере - без префикса пространства имен. |
| Возвращает указанный узел или узлы в кластере текущем пространстве имен URI первого узла. |
п: языки (языки) | Если язык текущего узла совпадает с указанным языком, он возвращает истину. Примеры: Lang ( "EN") верно для <р XML: LANG = "EN"> ... </ p> Примеры: Lang ( "де") ложно для <р XML: LANG = "EN"> ... </ p> |
| Возвращает корневой узел дерева или текущего узла принадлежит указанный узел. Обычно документ узла. |
Функции , связанные последовательности
общая функция
имя | объяснение |
---|---|
п: индекс-из ((пункт, пункт, ...), searchitem) | Назад в проекте, равной параметрам searchitem позиции последовательности. Примеры: индекс-в ((15, 40, 25, 40, 10), 40) Результаты: (2, 4) Примеры: индекс-системы (( "A", "собака", "и", "а", "утка"), "а") Результат (1, 4) Примеры: индекс-в ((15, 40, 25, 40, 10), 18) Результаты :() |
п: удалить ((пункт, пункт, ...), должность) | Она возвращает новую последовательность конфигурации параметров элемента - удалить параметр определяет положение проекта. Примеры: удалить (( "AB", "CD", "эф"), 0) Results :( "б", "CD", "эф") Примеры: удалить (( "AB", "CD", "эф"), 1) Результаты :( "CD", "эф") Примеры: удалить (( "AB", "CD", "эф"), 4) Results :( "б", "CD", "эф") |
п: пустой (пункт, пункт, ...) | Если значение параметра является пустая последовательность, она возвращает истину, в противном случае возвращает ложь. Примеры: пусто (удалить (( "AB", "CD"), 1)) Результаты: ложные |
п: существует (пункт, пункт, ...) | Если значение параметра не пустая последовательность, она возвращает истину, в противном случае возвращает ложь. Примеры: существует (удалить (( "AB"), 1)) Результаты: ложные |
Fn: отчетливые-значения ((пункт, пункт, ...), параметры сортировки) | Только возвращать разные значения. Примеры: отчетливые-значения ((1, 2, 3, 1, 2)) Результаты: (1, 2, 3) |
п: вставить-выше ((пункт, пункт, ...), поз, вкладыши) | Она возвращает новую последовательность, построенную параметром элемента - параметр, указывающий местоположение вставки вставляет значение параметра поз. Примеры: вставка-ранее (( "AB", "CD"), 0, "Г.Х.") Результаты :( "Г.Х.", "б", "CD") Примеры: вставка-ранее (( "AB", "CD"), 1, "Г.Х.") Результаты :( "Г.Х.", "б", "CD") Примеры: вставка-ранее (( "AB", "CD"), 2, "Г.Х.") Результаты :( "б", "Г.Х.", "CD") Примеры: вставка-ранее (( "AB", "CD"), 5, "Г.Х.") Результаты :( "AB", "CD", "Г.Х.") |
п: обратный ((пункт, пункт, ...)) | Возвращает обратный порядок указанных элементов. Примеры: обратный (( "AB", "CD", "эф")) Results :( "эф", "CD", "б") Примеры: обратный (( "AB")) Results :( "AB") |
Fn: подпоследовательности ((пункт, пункт, ...), старт, LEN) | Возвращает параметр запуска определяет местоположение проекта, чтобы вернуть длину последовательности, последовательности, заданной параметром лена. Расположение первого проекта 1. Примеры: подпоследовательности (($ элемент1, $ элемент2, $ элемент3, ...), 3) Результаты: ($ элемент3, ...) Примеры: подпоследовательности (($ элемент1, $ элемент2, $ элемент3, ...), 2, 2) Результаты: ($ item2, $ элемент3) |
п: неупорядоченный ((пункт, пункт, ...)) | В соответствии с порядком реализации решений, чтобы вернуться к проекту. |
Функция тестовой последовательности Емкость
имя | объяснение |
---|---|
п: нулевой или один (пункт, пункт, ...) | Если параметр содержит ноль или один элемент, а затем возвращать параметры, в противном случае возникает ошибка. |
п: один или более-(пункт, пункт, ...) | Если параметр содержит один или несколько элементов, а затем возвращать параметры, в противном случае возникает ошибка. |
п: ровно один (пункт, пункт, ...) | Если параметр содержит элемент, а затем возвращать параметры, в противном случае возникает ошибка. |
Равно, объединение, пересечение и за исключением случаев
имя | объяснение |
---|---|
п: глубоко равна (param1, param2, параметры сортировки) | Если param1 и param2 и равны друг другу (глубоко равны), возвращает истину, в противном случае возвращает ложь. |
Агрегатная функция
имя | объяснение |
---|---|
п: число ((пункт, пункт, ...)) | Возвращает количество узлов. |
п: ср ((Arg, Arg, ...)) | Средние значения параметров возврата. Примеры: СРЕДНЕМ ((1,2,3)) Результат: 2 |
п: тах ((Arg, Arg, ...)) | Возвращает параметр больше остальных параметров. Примеры: макс ((1,2,3)) Результаты: Примеры 3: макс (( 'а', 'к')) Результаты: 'K' |
п: мин ((Arg, Arg, ...)) | Назад меньше остальных параметров параметров. Примеры: мин ((1,2,3)) Результаты: Примеры 1: мин (( 'A', 'к')) Результаты: 'A' |
п: сумма (Arg, Arg, ...) | Возвращает указанный узел установки значения суммы каждого узла. |
Функция генерации последовательности
имя | объяснение |
---|---|
п: идентификатор ((строка, строка, ...), узел) | Возвращает последовательность узлов элементов, имеющих значение идентификатора, равное значению одного или нескольких из значений, указанных в строке аргумента |
п: IDREF ((строка, строка, ...), узел) | Возвращает последовательность элементов или атрибутов узлов, которые имеют значение IDREF, равную стоимости одного или нескольких значений, указанных в строке аргумента |
п: Doc (URI) | |
п: док-доступны (URI) | Если функция док () возвращает узел документа, он возвращает истину, в противном случае возвращает ложь. |
|
функции Контекст
имя | объяснение |
---|---|
п: положение () | Она возвращает позицию индекса узла обрабатывается. Примеры: // книга [положение () <= 3] Результаты: Выберите первые три элемента книги |
п: последний раз () | Она возвращает количество элементов в списке узлов в обработке. Примеры: // книга [последняя ()] Результаты: Выберите последний элемент книги |
п: ток-DATETIME () | Она возвращает текущий объект DateTime (с часовым поясом). |
Fn: текущая дата-() | Возвращает текущую дату (с часовым поясом). |
Fn: текущего времени () | Она возвращает текущее время (с часовым поясом). |
Fn: неявной часовой пояс () | Возвращаемое значение неявное часового пояса. |
п: по умолчанию-сортировки () | Управление возвращается к значению по умолчанию. |
п: статическая база-URI () | Возвращаемое значение базового URI. |