XPath, XQuery ja XSLT-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'), 'Virhe: Hinta on liian korkea')

Tulos: Palauttaa ulkoiseen käsittelyympäristöön http://example.com/test#toohigh ja merkkijonon "Virhe: Hinta on liian korkea".

Palauttaa parametrin arvon. Parametri voi olla totuusarvo, merkkijono tai solmuryhmä.

esimerkki:number('100')

Tulos: 100

Palauttaa parametrin absoluuttisen arvon.

esimerkki:abs(3.14)

Tulos: 3.14

esimerkki:abs(-3.14)

Tulos: 3.14

Palauttaa suurimman kokonaisluvun, joka on suurempi kuin parametri num.

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 numero, looginen arvo tai solmujoukko.

Esimerkki: string(314)

Tulos: "314"

Palauttaa merkkijonon merkkijonon.

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

Tulos: 'Thérèse'

Palauttaa merkkijonon merkkiarvot.

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, palauttaa -1. Jos comp1 on yhtä suuri kuin comp2, palauttaa 0. Jos comp1 on suurempi kuin comp2, palauttaa 1. (Käytetyn vertailusäännön mukaan).

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

Tulos: 0

Palauttaa merkkijonon yhdistämisen.

Esimerkki: concat('XPath ', 'on ', 'hauska!')

Tulos: 'XPath on hauska!'

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 start-alkaisesta sijainnista alkaen määritetyn pituuden merkkijono. Ensimmäisen merkin indeksi on 1. Jos len parametria ei ole annettu, palauta sijainnista start loppuun asti oleva alijono.

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 ei ole string parametria, palauta nykyisen solmun merkkijonovaran pituus.

Esimerkki: string-length('Beatles')

Tulos: 7

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

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

Esimerkki: normalize-space(' The　　　XML ')

Tulos: 'The XML'

Muunna string parametri isoksi kirjaimiksi.

Esimerkki: upper-case('The XML')

Tulos: 'THE XML'

Muunna string parametri pieniksi kirjaimiksi.

Esimerkki: lower-case('The XML')

Tulos: 'the xml'

Korvaa string1:ssä olevan string2:n string3:llä.

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:n, 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:een, palauttaa true, muuten false.

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

Tulos: false

Palauttaa merkkijonon string2, joka esiintyy merkkijonossa string1 ennen sen sijaintia.

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

Tulos: '12'

Palauttaa merkkijonon string2, joka esiintyy merkkijonossa string1 sen jälkeen.

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

Tulos: '10'

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

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

Tulos: true

Korvaa määritetyn mallin replace-parametrillä ja palauta 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 palautetaan parametri boolean()-funktiolla takaisin totuusarvoksi. Jos totuusarvo on false, palautetaan true, muuten palautetaan true.

Esimerkki: not(true())

Tulos: false

Palauttaa totuusarvon true.

Esimerkki: true()

Tulos: true

Palauttaa totuusarvon false.

Esimerkki: false()

Tulos: false

Palauttaa parametrin paikallisen arvon vuosiosan kokonaislukuna.

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

Tulos: 2005

Palauttaa parametrin paikallisen arvon kuukausiosan kokonaislukuna.

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

Tulos: 01

Palauttaa parametrin paikallisen arvon päiväosan kokonaislukuna.

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

Tulos: 10

Palauttaa parametrin paikallisen arvon tuntiosan kokonaislukuna.

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

Tulos: 12

Palauttaa parametrin paikallisen arvon minuuttiosan kokonaislukuna.

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

Tulos: 30

Palauttaa parametrin paikallisen arvon sekuntiosan desimaalimuodossa.

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

Tulos: 0

Palauttaa parametrin paikallisen arvon vuoden osana.

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

Tulos: 2005

Palauttaa parametrin paikallisen arvon kuukauden kokonaisluvuna.

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

Tulos: 4

Palauttaa parametrin paikallisen arvon päivän kokonaisluvuna.

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

Tulos: 23

Palauttaa parametrin paikallisen arvon tuntiosan kokonaisluvuna.

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

Tulos: 10

Palauttaa parametrin paikallisen arvon minuuttiosan kokonaisluvuna.

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

Tulos: 22

Palauttaa parametrin paikallisen arvon sekuntiosan kokonaisluvuna.

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

Tulos: 0

• 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 sijainnin, jossa hakuitem-parametrin määrittämä arvo on kohteiden sarjassa.

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, joka on rakennettu item-parametrin avulla - poistaa position-parametrin määrittämän 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 parametria on tyhjä jono, palauttaa true, muuten false.

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

Tulos: false

Jos parametrin arvo ei ole tyhjä sarja, 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 sarjan, joka on rakennettu item-parametrin avulla - samalla lisätään 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 kohteen 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 kohteiden sarjan, jonka pituus määritetään len-parametrilla. Ensimmäisen kohteen 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 arvon, joka on suurempi kuin muut parametrit.

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

Tulos: 3

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

Tulos: 'k'

Palauttaa arvon, joka on pienempi 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ä olevan solmun index-sijainti.

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

Tulos: Valitaan ensimmäiset kolme book-elementtiä

Palauta käsiteltävänä olevien solmujen luettelon kohteiden lukumäärä.

Esimerkki: //book[last()]

Tulos: Valitaan viimeinen book-elementti