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

esempio: error(fn:QName('http://example.com/test', 'err:toohigh'), 'Error: Price is too high')

Risultato: Restituisce all'ambiente di elaborazione esterno http://example.com/test#toohigh e la stringa "Error: Price is too high".

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

esempio: number('100')

Risultato: 100

Ritorna il valore assoluto del parametro.

esempio: abs(3.14)

Risultato: 3.14

esempio: abs(-3.14)

Risultato: 3.14

Ritorna l'intero più piccolo maggiore di 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: arrotonda(3.14)

Risultato: 3

Esempio: arrotonda-a-coppia-uguale(0.5)

Risultato: 0

Esempio: arrotonda-a-coppia-uguale(1.5)

Risultato: 2

Esempio: arrotonda-a-coppia-uguale(2.5)

Risultato: 2

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

Esempio: stringa(314)

Risultato: "314"

Restituisce una stringa da una sequenza di codici punto.

Esempio: codici-punto-a-stringa(84, 104, 233, 114, 232, 115, 101)

Risultato: 'Thérèse'

Restituisce una sequenza di codici punto da una stringa.

Esempio: stringa-a-codici-punto("Thérèse")

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

• fn:confronta(comp1,comp2)
• fn:confronta(comp1,comp2,collazione)

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 confronto utilizzate).

Esempio: confronta('ghi', 'ghi')

Risultato: 0

Restituisce la concatenazione di stringhe.

Esempio: concat('XPath ','è ','DIVERTENTE!')

Risultato: 'XPath è DIVERTENTE!}

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

Restituire la substriga specificata di lunghezza designata a partire dalla posizione start. L'indice del primo carattere è 1. Se viene omesso il parametro len, viene restituita la substriga da posizione 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()

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

Esempio: string-length('Beatles')

Risultato: 7

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

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

Esempio: normalize-space(' The　　　XML ')

Risultato: 'The XML'

Convertire il parametro string in maiuscolo.

Esempio: upper-case('The XML')

Risultato: 'THE XML'

Convertire 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 finisce con string2, restituisce true, altrimenti restituisce false.

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

risultato: false

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

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

Risultato: '12'

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

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

Risultato: '10'

Se il parametro stringa corrisponde al modello specificato, restituisce true, 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(). Se il valore booleano è false, restituisce true, 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 rappresentante la parte annuale del valore locale del parametro.

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

Risultato: 2005

Restituisce l'intero rappresentante la parte mensile del valore locale del parametro.

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

Risultato: 01

Restituisce l'intero rappresentante la parte giornaliera del valore locale del parametro.

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

Risultato: 10

Restituisce l'intero rappresentante la parte oraria del valore locale del parametro.

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

Risultato: 12

Restituisce l'intero rappresentante la parte minütia 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 rappresentante l'anno nel valore locale del parametro.

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

Risultato: 2005

Restituisce l'intero che rappresenta la parte mensile del valore locale del parametro.

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

Risultato: 4

Restituisce l'intero che rappresenta la parte giornaliera del valore locale del parametro.

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

Risultato: 23

Restituisce l'intero che rappresenta la parte oraria del valore locale del parametro.

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

Risultato: 10

Restituisce l'intero che rappresenta la parte minutoria del valore locale del parametro.

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

Risultato: 22

Restituisce l'intero che rappresenta la parte secondaria del valore locale del parametro.

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

Risultato: 0

• 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 degli elementi nella sequenza di oggetti che sono uguali 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 con il parametro item - elimina l'elemento specificato dalla posizione del parametro.

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

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

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

risultato: false

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

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

risultato: false

ritorna i valori unici.

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

risultato: (1, 2, 3)

ritorna una nuova sequenza costruita dal parametro item, inserendo il valore specificato nel parametro inserts alla posizione specificata dal parametro 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")

ritorna l'ordine inverso degli elementi specificati.

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

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

esempio: reverse(("ab"))

risultato: ("ab")

ritorna una sequenza di elementi specificata dalla posizione iniziale indicata dal parametro start e dalla lunghezza specificata dal parametro 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)

Restituisce la media dei valori dei parametri

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

Risultato: 2

Restituisce il parametro che è maggiore rispetto agli altri parametri

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

Risultato: 3

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

Risultato: 'k'

Restituisce il parametro che è minore rispetto agli altri parametri

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

Risultato: 1

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

Risultato: 'a'

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

Restituire la posizione dell'indice del nodo attualmente trattato.

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

Risultato: selezionare i primi tre elementi book

Restituire il numero di elementi nella lista dei nodi trattati.

Esempio: //book[last()]

Risultato: selezionare l'ultimo elemento book