Funções XPath, XQuery e XSLT

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

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

exemplo: error(fn:QName('http://example.com/test', 'err:toohigh'), 'Erro: O preço é muito alto')

resultado: retorna ao ambiente de processamento externo http://example.com/test#toohigh e a string "Erro: O preço é muito alto".

retorna o valor numérico do parâmetro. O parâmetro pode ser um valor booleano, uma string ou um conjunto de nós.

exemplo: number('100')

resultado: 100

retorna o valor absoluto do parâmetro.

exemplo: abs(3,14)

resultado: 3,14

exemplo: abs(-3,14)

resultado: 3,14

retorna o menor inteiro maior que o parâmetro num.

exemplo: ceiling(3,14)

Resultado: 4

Retorna o maior inteiro não superior ao parâmetro num.

Exemplo: floor(3.14)

Resultado: 3

Arredonda o parâmetro num para o inteiro mais próximo.

Exemplo: round(3.14)

Resultado: 3

Exemplo: round-half-to-even(0.5)

Resultado: 0

Exemplo: round-half-to-even(1.5)

Resultado: 2

Exemplo: round-half-to-even(2.5)

Resultado: 2

Retorna o valor de string do argumento. O argumento pode ser um número, valor lógico ou conjunto de nós.

Exemplo: string(314)

Resultado: "314"

Retorna uma string com base na sequência de código-pontos.

Exemplo: codepoints-to-string(84, 104, 233, 114, 232, 115, 101)

Resultado: 'Thérèse'

Retorna uma sequência de código-pontos com base na string.

Exemplo: string-to-codepoints("Thérèse")

Resultado: 84, 104, 233, 114, 232, 115, 101

• fn:compare(comp1,comp2)
• fn:compare(comp1,comp2,collation)

Se comp1 for menor que comp2, retorna -1. Se comp1 for igual a comp2, retorna 0. Se comp1 for maior que comp2, retorna 1. (Conforme o conjunto de regras de comparação utilizado).

Exemplo: compare('ghi', 'ghi')

Resultado: 0

Retorna a concatenação de strings.

Exemplo: concat('XPath ','é ','DIVERTIDO!')

Resultado: 'XPath é DIVERTIDO!'

Use the sep parameter as a separator to return the concatenated string of the string parameter.

example: string-join(('We', 'are', 'having', 'fun!'), ' ')

result: ' We are having fun! '

example: string-join(('We', 'are', 'having', 'fun!'))

result: 'Wearehavingfun!'

example: string-join((), 'sep')

result: ''

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

Return a substring of the specified length starting from the start position. The index of the first character is 1. If the len parameter is omitted, return the substring from position start to the end of the string.

example: substring('Beatles',1,4)

result: 'Beat'

example: substring('Beatles',2)

result: 'eatles'

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

Return the length of the specified string. If there is no string parameter, return the length of the string value of the current node.

example: string-length('Beatles')

result: 7

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

Remove the leading and trailing spaces of the specified string, replace all internal white space sequences with one, and then return the result. If there is no string parameter, then process the current node.

example: normalize-space(' The　　　XML ')

result: 'The XML'

Convert the string parameter to uppercase.

example: upper-case('The XML')

result: 'THE XML'

Convert the string parameter to lowercase.

example: lower-case('The XML')

result: 'the xml'

Substitui string2 por string3 dentro de string1.

Exemplo: translate('12:30','30','45')

Resultado: '12:45'

Exemplo: translate('12:30','03','54')

Resultado: '12:45'

Exemplo: translate('12:30','0123','abcd')

Resultado: 'bc:da'

Exemplo: escape-uri("http://example.com/test#car", true())

Resultado: "http%3A%2F%2Fexample.com%2Ftest#car"

Exemplo: escape-uri("http://example.com/test#car", false())

Resultado: "http://example.com/test#car"

Exemplo: escape-uri ("http://example.com/~bébé", false())

Resultado: "http://example.com/~b%C3%A9b%C3%A9"

Se string1 contiver string2, retorna true, caso contrário, retorna false.

Exemplo: contains('XML','XM')

Resultado: true

Se string1 começar com string2, retorna true, caso contrário, retorna false.

Exemplo: starts-with('XML','X')

Resultado: true

Se string1 terminar com string2, retorna true, caso contrário, retorna false.

Exemplo: ends-with('XML','X')

resultado: false

Retorna a substring que surge antes da ocorrência de string2 dentro de string1.

Exemplo: substring-before('12/10','/')

Resultado: '12'

Retorna a substring que surge após a ocorrência de string2 dentro de string1.

Exemplo: substring-after('12/10','/')

Resultado: '10'

Se o parâmetro string correspondente ao padrão especificado, retorna true; caso contrário, retorna false.

Exemplo: matches("Merano", "ran")

Resultado: true

Substitui o padrão especificado pelo parâmetro replace e retorna o resultado.

Exemplo: replace("Bella Italia", "l", "*")

Resultado: 'Be**a Ita*ia'

Exemplo: replace("Bella Italia", "l", "")

Resultado: 'Bea Itaia'

Exemplo: tokenize("XPath is fun", "\s+")

Resultado: ("XPath", "is", "fun")

Primeiro, a função boolean() recupera o valor booleano do parâmetro. Se o valor booleano for false, retorna true; caso contrário, retorna true.

Exemplo: not(true())

resultado: false

Retorna o valor booleano true.

Exemplo: true()

Resultado: true

Retorna o valor booleano false.

Exemplo: false()

resultado: false

Retorna o valor inteiro da parte local dos anos do parâmetro.

Exemplo: year-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Resultado: 2005

Retorna o valor inteiro da parte local dos meses do parâmetro.

Exemplo: month-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Resultado: 01

Retorna o valor inteiro da parte local dos dias do parâmetro.

Exemplo: day-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Resultado: 10

Retorna o valor inteiro da parte local das horas do parâmetro.

Exemplo: hours-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Resultado: 12

Retorna o valor inteiro da parte local dos minutos do parâmetro.

Exemplo: minutes-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Resultado: 30

Retorna o valor decimal de segundos da parte local do parâmetro.

Exemplo: seconds-from-dateTime(xs:dateTime("2005-01-10T12:30:00-04:10"))

Resultado: 0

Retorna o valor inteiro local do parâmetro.

Exemplo: year-from-date(xs:date("2005-04-23"))

Resultado: 2005

Retorna o inteiro representando o mês do valor local do parâmetro.

Exemplo: month-from-date(xs:date("2005-04-23"))

Resultado: 4

Retorna o inteiro representando o dia do valor local do parâmetro.

Exemplo: day-from-date(xs:date("2005-04-23"))

Resultado: 23

Retorna o inteiro representando a parte de horas do valor local do parâmetro.

Exemplo: hours-from-time(xs:time("10:22:00"))

Resultado: 10

Retorna o inteiro representando a parte de minutos do valor local do parâmetro.

Exemplo: minutes-from-time(xs:time("10:22:00"))

Resultado: 22

Retorna o inteiro representando a parte de segundos do valor local do parâmetro.

Exemplo: seconds-from-time(xs:time("10:22:00"))

Resultado: 0

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

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

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

Se o idioma do nó atual correspondente ao idioma especificado, retorna true.

Exemplo: Lang("en") é verdadeiro para <p xml:lang="en">...</p>

Exemplo: Lang("de") é falso para <p xml:lang="en">...</p>

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

Retorna a posição do item na sequência de itens igual ao parâmetro searchitem.

Exemplo: index-of ((15, 40, 25, 40, 10), 40)

Result: (2, 4)

Exemplo: index-of (("a", "dog", "and", "a", "duck"), "a")

Result (1, 4)

Exemplo: index-of ((15, 40, 25, 40, 10), 18)

Result: ()

Retorna uma nova sequência construída pelo parâmetro item, removendo o item especificado pela posição.

Exemplo: remove(("ab", "cd", "ef"), 0)

Result: ("ab", "cd", "ef")

Exemplo: remove(("ab", "cd", "ef"), 1)

Result: ("cd", "ef")

Exemplo: remove(("ab", "cd", "ef"), 4)

Result: ("ab", "cd", "ef")

Se o valor do parâmetro for uma sequência vazia, retorna true, caso contrário, retorna false.

Exemplo: empty(remove(("ab", "cd"), 1))

resultado: false

se o valor do parâmetro não for uma sequência vazia, retorna true, caso contrário, retorna false.

exemplo: exists(remove(("ab"), 1))

resultado: false

retorna os valores únicos diferentes.

exemplo: distinct-values((1, 2, 3, 1, 2))

resultado: (1, 2, 3)

retorna uma nova sequência construída pelo parâmetro item, inserindo o valor do parâmetro inserts na posição especificada pelo parâmetro pos.

exemplo: insert-before(("ab", "cd"), 0, "gh")

resultado: ("gh", "ab", "cd")

exemplo: insert-before(("ab", "cd"), 1, "gh")

resultado: ("gh", "ab", "cd")

exemplo: insert-before(("ab", "cd"), 2, "gh")

resultado: ("ab", "gh", "cd")

exemplo: insert-before(("ab", "cd"), 5, "gh")

resultado: ("ab", "cd", "gh")

retorna a inversão da ordem dos itens especificados.

exemplo: reverse(("ab", "cd", "ef"))

resultado: ("ef", "cd", "ab")

exemplo: reverse(("ab"))

resultado: ("ab")

retorna a sequência de itens especificada pelo parâmetro start, cujo comprimento é especificado pelo parâmetro len. A posição do primeiro item é 1.

exemplo: subsequence(($item1, $item2, $item3,...), 3)

resultado: ($item3, ...)

exemplo: subsequence(($item1, $item2, $item3, ...), 2, 2)

resultado: ($item2, $item3)

Retorna a média dos valores dos argumentos.

Exemplo: avg((1,2,3))

Resultado: 2

Retorna o argumento que é maior que os outros parâmetros.

Exemplo: max((1,2,3))

Resultado: 3

Exemplo: max(('a', 'k'))

Resultado: 'k'

Retorna o argumento que é menor que os outros parâmetros.

Exemplo: min((1,2,3))

Resultado: 1

Exemplo: min(('a', 'k'))

Resultado: 'a'

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

Retorna a posição do nó atualmente processado.

Exemplo: //book[position()<=3]

Resultado: Escolhe os três primeiros elementos book

Retorna o número de itens na lista de nós processados.

Exemplo: //book[last()]

Resultado: Escolhe o último elemento book