Funções do XSLT, XPath e XQuery

• 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'), 'Error: Price is too high')

Resultado: Retorna ao ambiente de processamento externo http://example.com/test#toohigh e a string "Error: Price is too high".

Retorna o valor 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 maior que o 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 parâmetro. O parâmetro pode ser um número, valor lógico ou conjunto de nós.

Exemplo: string(314)

Resultado: "314"

De acordo com a sequência de pontos de código, retorna a string.

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

Resultado: 'Thérèse'

De acordo com a string, retorna uma sequência de pontos de código.

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 padrão de comparação utilizado).

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

Resultado: 0

Retornar a concatenação de strings.

Exemplo: concat('XPath ','is ','FUN!')

Resultado: 'XPath is FUN!'

Usar o parâmetro sep como delimitador para retornar a string concatenada.

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

Resultado: ' We are having fun! '

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

Resultado: 'Wearehavingfun!'

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

Resultado: ''

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

Retornar a substring de comprimento especificado a partir da posição start. O índice do primeiro caractere é 1. Se o parâmetro len for omitido, retornar a substring da posição start até o final da string.

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

Resultado: 'Beat'

Exemplo: substring('Beatles',2)

Resultado: 'eatles'

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

Retornar o comprimento da string especificada. Se não houver parâmetro string, retornar o comprimento do valor de string do nó atual.

Exemplo: string-length('Beatles')

Resultado: 7

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

Remover os espaços em branco no início e no final da string especificada, substituir todas as sequências de espaços internos por um único espaço e retornar o resultado. Se não houver parâmetro string, processar o nó atual.

Exemplo: normalize-space(' The　　　XML ')

Resultado: 'The XML'

Converter o parâmetro string para maiúsculo.

Exemplo: upper-case('The XML')

Resultado: 'THE XML'

Converte o parâmetro string para minúsculas.

Exemplo: lower-case('The XML')

Resultado: '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 contém string2, retorna true, caso contrário, retorna false.

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

Resultado: true

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

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

Resultado: true

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

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

Resultado: false

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

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

Resultado: '12'

Retorna a substring que aparece após string2 em 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, recupera o valor booleano do parâmetro usando a função boolean().

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 inteiro da parte do ano do valor local do parâmetro.

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

Resultado: 2005

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

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

Resultado: 01

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

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

Resultado: 10

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

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

Resultado: 12

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

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

Resultado: 30

Retorna o número decimal da parte do segundo do valor local do parâmetro.

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

Resultado: 0

Retorna o inteiro representando o ano do valor 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

Se o parâmetro timezone estiver vazio, retorna o dateTime sem fuso horário.

Caso contrário, retorna o dateTime com fuso horário.

Se o parâmetro timezone estiver vazio, retorna a data sem fuso horário.

Caso contrário, retorna a data com fuso horário.

Se o parâmetro timezone estiver vazio, retorna o time sem fuso horário.

Caso contrário, retorna a hora com fuso horário.

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

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

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

Retorna true se o idioma do nó atual coincidir com o idioma especificado.

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)

Resultado: (2, 4)

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

Resultado (1, 4)

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

Result: ()

Retorna uma nova sequência construída pelo parâmetro item - remove o item especificado pelo parâmetro position.

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

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

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

Resultado: ("cd", "ef")

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

Resultado: ("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, com 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 parâmetros.

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

Resultado: 2

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

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

Resultado: 3

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

Resultado: 'k'

Retorna o parâmetro 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)

Retornar a posição index do nó atualmente processado.

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

Resultado: Selecionar os três primeiros elementos book

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

Exemplo: //book[last()]

Resultado: Selecionar o último elemento book