Funzioni 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)

Esempio: error(fn:QName('http://example.com/test', 'err:toohigh'), 'Error: Prezzo troppo alto')

Risultato: restituisce all'ambiente di elaborazione esterno http://example.com/test#toohigh e la stringa "Error: Prezzo troppo alto".

Restituisce il valore del parametro. Il parametro può essere un valore booleano, una stringa o un insieme di nodi.

Esempio: number('100')

Risultato: 100

Restituisce il valore assoluto del parametro.

Esempio: abs(3.14)

Risultato: 3.14

Esempio: abs(-3.14)

Risultato: 3.14

Restituisce il numero intero minimo maggiore del parametro num.

Esempio: ceiling(3.14)

Risultato: 4

Restituisce il numero intero massimo non superiore al parametro num.

Esempio: floor(3.14)

Risultato: 3

Arrotonda il parametro num al numero intero più vicino.

Esempio: round(3.14)

Risultato: 3

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

Risultato: 0

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

Risultato: 2

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

Risultato: 2

Restituisce il valore di stringa dell'argomento. Gli argomenti possono essere numeri, valori logici o insiemi di nodi.

Esempio: string(314)

Risultato: "314"

Restituisce una stringa da una sequenza di codici Unicode.

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

Risultato: 'Thérèse'

Restituisce una sequenza di codici Unicode da una stringa.

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

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

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

Se comp1 è minore di comp2, restituisce -1. Se comp1 è uguale a comp2, restituisce 0. Se comp1 è maggiore di comp2, restituisce 1 (in base alle regole di collazione utilizzate).

Esempio: compare('ghi', 'ghi')

Risultato: 0

Restituisci la concatenazione delle stringhe.

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

Risultato: 'XPath is FUN!'

Usa il parametro sep come separatore per restituire la stringa concatenata dei parametri string.

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

Risultato: ' We are having fun! '

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

Risultato: 'Wearehavingfun!'

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

Risultato: ''

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

Restituisci la sottostringa specificata di lunghezza specificata a partire dalla posizione start. L'indice del primo carattere è 1. Se viene omesso il parametro len, viene restituita la sottostringa da start alla fine della stringa.

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

Risultato: 'Beat'

Esempio: substring('Beatles',2)

Risultato: 'eatles'

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

Restituisci la lunghezza della stringa specificata. Se non viene fornito il parametro string, restituisci la lunghezza del valore stringa del nodo corrente.

Esempio: string-length('Beatles')

Risultato: 7

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

Elimina gli spazi iniziali e finali della stringa specificata e sostituisci tutte le sequenze di spazi interni con un singolo spazio, quindi restituisci il risultato. Se non viene fornito il parametro string, viene trattato il nodo corrente.

Esempio: normalize-space(' The　　　XML ')

Risultato: 'The XML'

Converti il parametro string in maiuscolo.

Esempio: upper-case('The XML')

Risultato: 'THE XML'

Converti il parametro string in minuscolo.

Esempio: lower-case('The XML')

Risultato: 'the xml'

Sostituisci string2 in string1 con string3.

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

Risultato: '12:45'

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

Risultato: '12:45'

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

Risultato: 'bc:da'

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

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

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

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

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

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

Se string1 contiene string2, restituisce true, altrimenti restituisce false.

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

Risultato: true

Se string1 inizia con string2, restituisce true, altrimenti restituisce false.

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

Risultato: true

Se string1 termina con string2, restituisce true, altrimenti restituisce false.

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

Risultato: false

Restituisce la sottostringa antecedente a string2 all'interno di string1.

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

Risultato: '12'

Restituisce la substrings successiva a string2 in string1.

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

Risultato: '10'

Restituisce true se la stringa parametrica corrisponde al modello specificato, altrimenti restituisce false.

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

Risultato: true

Sostituisci il modello specificato con il parametro replace e restituisci il risultato.

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

Risultato: 'Be**a Ita*ia'

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

Risultato: 'Bea Itaia'

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

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

Prima di tutto, riporta il parametro a un valore booleano utilizzando la funzione boolean().

Restituisce true se il valore booleano è false, altrimenti restituisce true.

Esempio: not(true())

Risultato: false

Restituisce il valore booleano true.

Esempio: true()

Risultato: true

Restituisce il valore booleano false.

Esempio: false()

Risultato: false

Restituisce l'intero della parte annuale del valore locale del parametro.

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

Risultato: 2005

Restituisce l'intero della parte mensile del valore locale del parametro.

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

Risultato: 01

Restituisce l'intero della parte giornaliera del valore locale del parametro.

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

Risultato: 10

Restituisce l'intero della parte oraria del valore locale del parametro.

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

Risultato: 12

Restituisce l'intero della parte minütiva del valore locale del parametro.

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

Risultato: 30

Restituisce il numero decimale della parte secondaria del valore locale del parametro.

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

Risultato: 0

Restituisce l'intero parte anni del valore locale del parametro.

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

Risultato: 2005

Restituisce l'intero parte mesi del valore locale del parametro.

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

Risultato: 4

Restituisce l'intero parte giorni del valore locale del parametro.

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

Risultato: 23

Restituisce l'intero parte ore del valore locale del parametro.

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

Risultato: 10

Restituisce l'intero parte minuti del valore locale del parametro.

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

Risultato: 22

Restituisce l'intero parte secondi del valore locale del parametro.

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

Risultato: 0

Se il parametro timezone è vuoto, viene restituito il dateTime senza fuso orario.

Altrimenti viene restituito il dateTime con fuso orario.

Se il parametro timezone è vuoto, viene restituito la data senza fuso orario.

Altrimenti viene restituito la data con fuso orario.

Se il parametro timezone è vuoto, viene restituito il time senza fuso orario.

Altrimenti restituisce il tempo con il fuso orario.

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

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

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

Restituisce true se il linguaggio del nodo corrente corrisponde al linguaggio specificato.

Esempio: Lang("en") è true per <p xml:lang="en">...</p>

Esempio: Lang("de") è false per <p xml:lang="en">...</p>

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

Restituisce la posizione dell'elemento nella sequenza di elementi uguale al parametro searchitem.

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

Risultato: (2, 4)

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

Risultato (1, 4)

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

Risultato: ()

Restituisce una nuova sequenza costruita dal parametro item - contemporaneamente elimina l'elemento specificato dal parametro posizione.

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

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

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

Risultato: ("cd", "ef")

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

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

Restituisce true se il valore del parametro è una sequenza vuota, altrimenti restituisce false.

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

Risultato: false

Restituisce true se il valore del parametro non è una sequenza vuota, altrimenti restituisce false.

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

Risultato: false

Restituisce i valori unici.

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

Risultato: (1, 2, 3)

Restituisce una nuova sequenza costruita dal parametro item, inserendo il valore di inserts nella posizione specificata da pos.

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

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

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

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

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

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

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

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

Restituisce l'ordine inverso degli elementi specificati.

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

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

Esempio: reverse(("ab"))

Risultato: ("ab")

Restituisce la sequenza di elementi specificata da start e la lunghezza specificata da len.

La posizione del primo elemento è 1.

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

Risultato: ($item3, ...)

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

Risultato: ($item2, $item3)

Ritorna la media dei valori dei parametri.

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

Risultato: 2

Ritorna il parametro più grande rispetto agli altri parametri.

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

Risultato: 3

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

Risultato: 'k'

Ritorna il parametro più piccolo rispetto agli altri parametri.

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

Risultato: 1

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

Risultato: 'a'

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

Ritorna l'indice della posizione del nodo corrente che viene trattato.

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

Risultato: seleziona i primi tre elementi book

Ritorna il numero di elementi nella lista dei nodi trattati.

Esempio: //book[last()]

Risultato: seleziona l'ultimo elemento book