XSLT, XPath ja XQuery - funktiot

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

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

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

Tulos: Palauttaa ulkoiseen käsittelyympäristöön http://example.com/test#toohigh ja merkkijonon "Error: Price is too high".

Palauttaa parametarin arvon. Parametri voi olla totuusarvo, merkkijono tai solujen joukko.

Esimerkki: number('100')

Tulos: 100

Palauttaa parametrin absoluuttisen arvon.

Esimerkki: abs(3.14)

Tulos: 3.14

Esimerkki: abs(-3.14)

Tulos: 3.14

Palauttaa pienimmän kokonaisluvun, joka on suurempi kuin num parametrin.

Esimerkki: ceiling(3.14)

Tulos: 4

Palauttaa suurimman kokonaisluvun, joka ei ole suurempi kuin num parametrin.

Esimerkki: floor(3.14)

Tulos: 3

Pyöristää num parametrin lähimmäksi kokonaislukua.

Esimerkki: round(3.14)

Tulos: 3

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

Tulos: 0

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

Tulos: 2

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

Tulos: 2

Palauttaa parametrin merkkijonon arvon. Parametri voi olla luku, looginen arvo tai solukokoelma.

Esimerkki: string(314)

Tulos: "314"

Palauttaa merkkikoodeja sarjasta merkkijonon.

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

Tulos: 'Thérèse'

Palauttaa merkkijonon merkkikoodeja sarjana.

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

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

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

Jos comp1 on pienempi kuin comp2, palauta -1. Jos comp1 on yhtä suuri kuin comp2, palauta 0. Jos comp1 on suurempi kuin comp2, palauta 1. (Käytetyn vertailusäännön mukaan).

Esimerkki: compare('ghi', 'ghi')

Tulos: 0

Palauta merkkijonojen yhdistelmä.

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

Tulos: 'XPath is FUN!'

Käytä sep-parametria erottimena palauttaaksesi merkkijonojen yhdistelmän.

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

Tulos: ' We are having fun! '

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

Tulos: 'Wearehavingfun!'

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

Tulos: ''

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

Palauta alusta start-positioon alkavaan määritettyyn pituuteen asti oleva alimerkkijono. Ensimmäisen merkin indeksi on 1. Jos len-parametria ei ole määritelty, palauta alusta start-positioon merkkijonon loppuun asti oleva alimerkkijono.

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

Tulos: 'Beat'

Esimerkki: substring('Beatles',2)

Tulos: 'eatles'

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

Palauta määritetyn merkkijonon pituus. Jos string-parametria ei ole, palauta nykyisen solmun merkkijonoarvon pituus.

Esimerkki: string-length('Beatles')

Tulos: 7

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

Poista määritetty merkkijonojen alun ja lopun välit, korvaa sisäiset välilyöntijonot yhdellä välilyönnillä ja palauta tulos. Jos string-parametria ei ole, käsittele nykyinen solmu.

Esimerkki: normalize-space(' The　　　XML ')

Tulos: 'The XML'

Muunna string-parametri isolla kirjaimella.

Esimerkki: upper-case('The XML')

Tulos: 'THE XML'

Muunna string-parametri pieniksi kirjaimiksi.

Esimerkki: lower-case('The XML')

Tulos: 'the xml'

Vaihda string1:ssä oleva string2 string3:ksi.

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

Tulos: '12:45'

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

Tulos: '12:45'

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

Tulos: 'bc:da'

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

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

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

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

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

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

Jos string1 sisältää string2, palauttaa true, muuten false.

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

Tulos: true

Jos string1 alkaa string2:lla, palauttaa true, muuten false.

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

Tulos: true

Jos string1 päätyy string2:lla, palauttaa true, muuten false.

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

Tulos: false

Palauttaa merkkijonon string2 esiintymisen ennen string1:n osan.

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

Tulos: '12'

Palauttaa string2:n string1:ssä olevan osan, joka on string2:n jälkeen.

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

Tulos: '10'

Jos string-parametri sopii määritettyyn malliin, palauttaa true, muuten palauttaa false.

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

Tulos: true

Määritettyjä malleja korvataan replace-parametrillä ja palautetaan tulos.

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

Tulos: 'Be**a Ita*ia'

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

Tulos: 'Bea Itaia'

Esimerkki: tokenize("XPath on fun", "\s+")

Tulos: ("XPath", "on", "fun")

Ensiksi palauttaa parametrin boolean-arvoksi boolean()-funktiolla.

Jos boolean-arvo on false, palauttaa true, muuten palauttaa true.

Esimerkki: not(true())

Tulos: false

Palauttaa boolean-arvon true.

Esimerkki: true()

Tulos: true

Palauttaa boolean-arvon false.

Esimerkki: false()

Tulos: false

Palauttaa parametrin paikallisen arvon vuosiosan kokonaislukuina.

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

Tulos: 2005

Palauttaa parametrin paikallisen arvon kuukausiosan kokonaislukuina.

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

Tulos: 01

Palauttaa parametrin paikallisen arvon päiväosan kokonaislukuina.

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

Tulos: 10

Palauttaa parametrin paikallisen arvon tunninosan kokonaislukuina.

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

Tulos: 12

Palauttaa parametrin paikallisen arvon minuuttiosan kokonaislukuina.

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

Tulos: 30

Palauttaa parametrin paikallisen arvon sekuntiosan desimaalilukuina.

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

Tulos: 0

Palautetaan parametrin paikallinen arvo, joka edustaa vuotta kokonaislukuna.

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

Tulos: 2005

Palautetaan parametrin paikallinen arvo, joka edustaa kuukauden kokonaislukuna.

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

Tulos: 4

Palautetaan parametrin paikallinen arvo, joka edustaa päivän kokonaislukuna.

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

Tulos: 23

Palautetaan parametrin paikallinen arvo, joka edustaa tuntiosaa kokonaislukuna.

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

Tulos: 10

Palautetaan parametrin paikallinen arvo, joka edustaa minuuttiosaa kokonaislukuna.

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

Tulos: 22

Palautetaan parametrin paikallinen arvo, joka edustaa sekuntiosaa kokonaislukuna.

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

Tulos: 0

Jos timezone-parametri on tyhjä, palautetaan dateTime ilman aikavyöhykettä.

Muussa tapauksessa palautetaan aikavyöhykkeellä varustettu dateTime.

Jos timezone-parametri on tyhjä, palautetaan päivämäärä ilman aikavyöhykettä.

Muussa tapauksessa palautetaan aikavyöhykkeellä varustettu päivämäärä.

Jos timezone-parametri on tyhjä, palautetaan aika ilman aikavyöhykettä.

Muussa tapauksessa palauttaa ajastuksen kanssa varustetun ajan.

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

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

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

Jos nykyisen solmun kieli vastaa määritettyä kieltä, palauttaa true.

Esimerkki: Lang("en") on true for <p xml:lang="en">...</p>

Esimerkki: Lang("de") on false for <p xml:lang="en">...</p>

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

Palauttaa etsittävässä kohteessa searchitem-argumentin arvoa vastaavan sijainnin.

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

Tulos: (2, 4)

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

Tulos (1, 4)

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

Tulos: ()

Palauttaa uuden sarjan item-argumentista - poistaa position-argumentilla määritetyn kohteen.

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

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

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

Tulos: ("cd", "ef")

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

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

Jos parametrin arvo on tyhjä sekvenssi, palauttaa true, muuten palauttaa false.

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

Tulos: false

Jos parametrin arvo ei ole tyhjä sekvenssi, palauttaa true, muuten palauttaa false.

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

Tulos: false

Palauttaa ainutlaatuiset arvot.

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

Tulos: (1, 2, 3)

Palauttaa uuden sekvenssin item-parametrin avulla - lisätään myös inserts-parametrin arvo pos-parametrin määrittämään sijaintiin.

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

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

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

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

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

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

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

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

Palauttaa määritetyn projektin käänteisen järjestyksen.

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

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

Esimerkki: reverse(("ab"))

Tulos: ("ab")

Palauttaa start-parametrin määrittämän sijainnin palauttamaan projekti-sekvenssin, jonka pituus määritetään len-parametrilla.

Ensimmäisen projektin sijainti on 1.

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

Tulos: ($item3, ...)

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

Tulos: ($item2, $item3)

Palauttaa parametrien arvojen keskiarvon.

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

Tulos: 2

Palauttaa suuremman arvon kuin muut parametrit.

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

Tulos: 3

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

Tulos: 'k'

Palauttaa pienemmän arvon kuin muut parametrit.

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

Tulos: 1

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

Tulos: 'a'

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

Palauta käsiteltävän solun index-positio.

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

Tulos: Valitaan ensimmäiset kolme book-elementtiä

Palauta käsiteltävien solujen luettelossa olevien kohteiden määrä.

Esimerkki: //book[last()]

Tulos: Valitaan viimeinen book-elementti